@apteva/integrations 0.3.62 → 0.15.4

package/src/apps/instagram-api.json

@@ -10,7 +10,7 @@
     "videos",
     "analytics"
   ],
-  "base_url": "https://graph.instagram.com",
+  "base_url": "https://graph.facebook.com/v25.0",
   "auth": {
     "types": [
       "bearer",
@@ -38,8 +38,8 @@
       }
     ],
     "oauth2": {
-      "authorize_url": "https://api.instagram.com/oauth/authorize",
-      "token_url": "https://api.instagram.com/oauth/access_token",
+      "authorize_url": "https://www.facebook.com/v25.0/dialog/oauth",
+      "token_url": "https://graph.facebook.com/v25.0/oauth/access_token",
       "scopes": [
         "user_profile",
         "user_media",
@@ -58,12 +58,32 @@
   "tools": [
     {
       "name": "list_accounts",
-      "description": "List Instagram Business Accounts linked to Facebook Pages accessible via your token. Use this first to get the instagramAccountId needed for other Instagram tools.",
+      "description": "List Instagram Business Accounts linked to Facebook Pages accessible via your token. Use this first to get the instagramAccountId needed for other Instagram tools. Returns Facebook Pages with their linked instagram_business_account (id, username, profile_picture_url) and the page-level access_token needed for posting.",
       "method": "GET",
-      "path": "/list-accounts",
+      "path": "/me/accounts",
       "input_schema": {
         "type": "object",
-        "properties": {}
+        "properties": {
+          "fields": {
+            "type": "string",
+            "description": "Graph API fields selector",
+            "default": "name,access_token,instagram_business_account{id,username,profile_picture_url}"
+          }
+        }
+      },
+      "mock_response": {
+        "data": [
+          {
+            "id": "100200300400500",
+            "name": "Apteva",
+            "instagram_business_account": {
+              "id": "17841400000000001"
+            }
+          }
+        ],
+        "paging": {
+          "cursors": {}
+        }
       }
     },
     {
@@ -87,6 +107,16 @@
         "required": [
           "instagramAccountId"
         ]
+      },
+      "mock_response": {
+        "id": "17841400000000001",
+        "username": "apteva",
+        "name": "Apteva",
+        "biography": "Continuous thinking engine",
+        "followers_count": 2480,
+        "follows_count": 180,
+        "media_count": 64,
+        "profile_picture_url": "https://scontent.cdninstagram.com/mock-profile.jpg"
       }
     },
     {
@@ -128,6 +158,23 @@
         "required": [
           "instagramAccountId"
         ]
+      },
+      "mock_response": {
+        "data": [
+          {
+            "id": "17900000000000099",
+            "caption": "Launch day!",
+            "media_type": "IMAGE",
+            "media_url": "https://scontent.cdninstagram.com/mock-media1.jpg",
+            "permalink": "https://www.instagram.com/p/CmOckPost1/",
+            "timestamp": "2026-05-22T12:00:00+0000",
+            "like_count": 210,
+            "comments_count": 18
+          }
+        ],
+        "paging": {
+          "cursors": {}
+        }
       }
     },
     {
@@ -151,13 +198,23 @@
         "required": [
           "mediaId"
         ]
+      },
+      "mock_response": {
+        "id": "17900000000000099",
+        "caption": "Launch day!",
+        "media_type": "IMAGE",
+        "media_url": "https://scontent.cdninstagram.com/mock-media1.jpg",
+        "permalink": "https://www.instagram.com/p/CmOckPost1/",
+        "timestamp": "2026-05-22T12:00:00+0000",
+        "like_count": 210,
+        "comments_count": 18
       }
     },
     {
       "name": "create_media_container",
       "description": "Step 1 of 2 to publish on Instagram. Create a media container with image/video URL and caption. Returns containerId for step 2 (publish-media-container). For videos: use sync=true to wait for processing to complete automatically (recommended), or poll manually with get-container-status.\n\nFor CAROUSEL posts: 1) Create child containers with isCarouselItem=true (each with imageUrl or videoUrl, mediaType IMAGE or REELS). 2) Create parent carousel container via Graph API: POST /{instagramAccountId}/media with media_type=CAROUSEL, children={comma-separated child IDs}, and caption. 3) Publish the parent container with publish-media-container. Up to 10 items per carousel.",
       "method": "POST",
-      "path": "/create-media-container",
+      "path": "/{instagramAccountId}/media",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -236,18 +293,25 @@
             "type": "boolean",
             "description": "Whether this is a carousel item",
             "default": false
+          },
+          "access_token": {
+            "type": "string",
+            "description": "Page-level access token (from list_accounts → access_token). Required for IG Business writes."
           }
         },
         "required": [
           "instagramAccountId"
         ]
+      },
+      "mock_response": {
+        "id": "17900000000000001"
       }
     },
     {
       "name": "publish_media_container",
-      "description": "Step 2 of 2 to publish on Instagram. Publishes the container created in step 1. For videos, check status first with get-container-status to ensure processing is complete.",
-      "method": "GET",
-      "path": "/publish-media-container",
+      "description": "Step 2 of 2 to publish on Instagram. Publishes the container created in step 1. For videos, check status first with get-container-status to ensure processing is complete. Also requires access_token (page-level token from list_accounts → access_token) for IG Business writes.",
+      "method": "POST",
+      "path": "/{instagramAccountId}/media_publish",
       "input_schema": {
         "type": "object",
         "properties": {
@@ -257,13 +321,24 @@
           },
           "containerId": {
             "type": "string",
-            "description": "The 'id' returned from create-media-container (step 1). This is the container ID to publish."
+            "description": "The 'id' returned from create-media-container (step 1). Sent as creation_id query param to Graph API."
+          },
+          "creation_id": {
+            "type": "string",
+            "description": "Alias for containerId — Graph API expects this field name. The Social app sends both for compatibility."
+          },
+          "access_token": {
+            "type": "string",
+            "description": "Page-level access token (from list_accounts). Required for IG Business writes."
           }
         },
         "required": [
           "instagramAccountId",
           "containerId"
         ]
+      },
+      "mock_response": {
+        "id": "17900000000000099"
       }
     },
     {
@@ -287,6 +362,10 @@
         "required": [
           "containerId"
         ]
+      },
+      "mock_response": {
+        "status_code": "FINISHED",
+        "id": "17900000000000001"
       }
     },
     {
@@ -316,6 +395,20 @@
         "required": [
           "mediaId"
         ]
+      },
+      "mock_response": {
+        "data": [
+          {
+            "id": "17900000000000200",
+            "text": "Amazing!",
+            "username": "fan_user",
+            "timestamp": "2026-05-22T10:30:00+0000",
+            "like_count": 4
+          }
+        ],
+        "paging": {
+          "cursors": {}
+        }
       }
     },
     {
@@ -339,6 +432,9 @@
           "commentId",
           "message"
         ]
+      },
+      "mock_response": {
+        "id": "17900000000000201"
       }
     },
     {
@@ -357,6 +453,9 @@
         "required": [
           "commentId"
         ]
+      },
+      "mock_response": {
+        "success": true
       }
     },
     {
@@ -421,6 +520,22 @@
         "required": [
           "instagramAccountId"
         ]
+      },
+      "mock_response": {
+        "data": [
+          {
+            "name": "reach",
+            "period": "day",
+            "values": [
+              {
+                "value": 3120,
+                "end_time": "2026-05-22T07:00:00+0000"
+              }
+            ],
+            "title": "Reach",
+            "id": "17841400000000001/insights/reach/day"
+          }
+        ]
       }
     },
     {
@@ -462,6 +577,32 @@
         "required": [
           "mediaId"
         ]
+      },
+      "mock_response": {
+        "data": [
+          {
+            "name": "impressions",
+            "period": "lifetime",
+            "values": [
+              {
+                "value": 4200
+              }
+            ],
+            "title": "Impressions",
+            "id": "17900000000000099/insights/impressions/lifetime"
+          },
+          {
+            "name": "reach",
+            "period": "lifetime",
+            "values": [
+              {
+                "value": 3650
+              }
+            ],
+            "title": "Reach",
+            "id": "17900000000000099/insights/reach/lifetime"
+          }
+        ]
       }
     },
     {
@@ -485,6 +626,13 @@
         "required": [
           "commentId"
         ]
+      },
+      "mock_response": {
+        "id": "17900000000000200",
+        "text": "Amazing!",
+        "username": "fan_user",
+        "timestamp": "2026-05-22T10:30:00+0000",
+        "like_count": 4
       }
     },
     {
@@ -514,6 +662,20 @@
         "required": [
           "commentId"
         ]
+      },
+      "mock_response": {
+        "data": [
+          {
+            "id": "17900000000000202",
+            "text": "Thanks!",
+            "username": "apteva",
+            "timestamp": "2026-05-22T11:00:00+0000",
+            "like_count": 0
+          }
+        ],
+        "paging": {
+          "cursors": {}
+        }
       }
     },
     {
@@ -537,6 +699,15 @@
         "required": [
           "mediaId"
         ]
+      },
+      "mock_response": {
+        "data": [
+          {
+            "id": "17900000000000300",
+            "media_type": "IMAGE",
+            "media_url": "https://scontent.cdninstagram.com/mock-child1.jpg"
+          }
+        ]
       }
     },
     {
@@ -560,6 +731,9 @@
         "required": [
           "commentId"
         ]
+      },
+      "mock_response": {
+        "success": true
       }
     }
   ]

package/src/apps/instantly.json

@@ -0,0 +1,169 @@
+{
+  "slug": "instantly",
+  "name": "Instantly",
+  "description": "Cold-email outreach platform — multi-inbox sending with built-in warmup, sequencing, A/B testing, and unibox reply management. Modern Apollo-killer for the actual sending step.",
+  "logo": "https://www.google.com/s2/favicons?domain=instantly.ai&sz=128",
+  "categories": ["email", "outreach", "sequencing", "campaigns", "sales", "cold-email"],
+  "base_url": "https://api.instantly.ai/api/v2",
+  "auth": {
+    "types": ["bearer"],
+    "headers": {
+      "Authorization": "Bearer {{api_key}}"
+    },
+    "credential_fields": [
+      {
+        "name": "api_key",
+        "label": "API key",
+        "description": "Instantly v2 API key from app.instantly.ai → Settings → Integrations → API Keys"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "list_campaigns",
+      "description": "List all email campaigns.",
+      "method": "GET",
+      "path": "/campaigns",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": { "type": "integer", "default": 25 },
+          "starting_after": { "type": "string", "description": "Cursor for pagination" },
+          "search": { "type": "string" }
+        }
+      }
+    },
+    {
+      "name": "create_campaign",
+      "description": "Create a new email campaign.",
+      "method": "POST",
+      "path": "/campaigns",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string" },
+          "campaign_schedule": { "type": "object", "description": "{ schedules: [{ name, timing: { from, to }, days: { 0..6 }, timezone }] }" },
+          "sequences": { "type": "array", "items": { "type": "object" }, "description": "Array of step objects: { steps: [{ type:'email', delay, variants:[{ subject, body }] }] }" },
+          "email_list": { "type": "array", "items": { "type": "string" }, "description": "Sending mailbox emails to use" },
+          "daily_limit": { "type": "integer" },
+          "stop_on_reply": { "type": "boolean", "default": true },
+          "stop_on_auto_reply": { "type": "boolean", "default": true },
+          "link_tracking": { "type": "boolean", "default": false },
+          "open_tracking": { "type": "boolean", "default": false },
+          "text_only": { "type": "boolean", "default": true }
+        },
+        "required": ["name"]
+      }
+    },
+    {
+      "name": "get_campaign",
+      "description": "Get a single campaign by id.",
+      "method": "GET",
+      "path": "/campaigns/{id}",
+      "input_schema": {
+        "type": "object",
+        "properties": { "id": { "type": "string" } },
+        "required": ["id"]
+      }
+    },
+    {
+      "name": "activate_campaign",
+      "description": "Activate (start) a campaign.",
+      "method": "POST",
+      "path": "/campaigns/{id}/activate",
+      "input_schema": {
+        "type": "object",
+        "properties": { "id": { "type": "string" } },
+        "required": ["id"]
+      }
+    },
+    {
+      "name": "pause_campaign",
+      "description": "Pause a running campaign.",
+      "method": "POST",
+      "path": "/campaigns/{id}/pause",
+      "input_schema": {
+        "type": "object",
+        "properties": { "id": { "type": "string" } },
+        "required": ["id"]
+      }
+    },
+    {
+      "name": "list_leads",
+      "description": "List leads, optionally filtered by campaign or list.",
+      "method": "POST",
+      "path": "/leads/list",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "campaign": { "type": "string" },
+          "list_id": { "type": "string" },
+          "limit": { "type": "integer", "default": 25 },
+          "starting_after": { "type": "string" },
+          "search": { "type": "string" },
+          "filter": { "type": "string", "description": "Status filter" }
+        }
+      }
+    },
+    {
+      "name": "add_leads",
+      "description": "Add leads to a campaign or list. Bulk-friendly.",
+      "method": "POST",
+      "path": "/leads",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "campaign": { "type": "string", "description": "Campaign id" },
+          "list_id": { "type": "string", "description": "Or list id (alternative to campaign)" },
+          "skip_if_in_workspace": { "type": "boolean", "default": true },
+          "skip_if_in_campaign": { "type": "boolean", "default": false },
+          "leads": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "email": { "type": "string" },
+                "first_name": { "type": "string" },
+                "last_name": { "type": "string" },
+                "company_name": { "type": "string" },
+                "personalization": { "type": "string", "description": "Custom intro line" },
+                "phone": { "type": "string" },
+                "website": { "type": "string" },
+                "custom_variables": { "type": "object" }
+              },
+              "required": ["email"]
+            }
+          }
+        },
+        "required": ["leads"]
+      }
+    },
+    {
+      "name": "campaign_analytics",
+      "description": "Get analytics (sent, opened, replied, etc.) for a campaign or all campaigns.",
+      "method": "GET",
+      "path": "/campaigns/analytics",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "id": { "type": "string", "description": "Campaign id (omit for all campaigns)" },
+          "start_date": { "type": "string", "description": "YYYY-MM-DD" },
+          "end_date": { "type": "string" }
+        }
+      }
+    },
+    {
+      "name": "list_email_accounts",
+      "description": "List connected sending mailboxes (and their warmup state).",
+      "method": "GET",
+      "path": "/accounts",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": { "type": "integer", "default": 25 },
+          "starting_after": { "type": "string" }
+        }
+      }
+    }
+  ]
+}