@apteva/integrations 0.3.62 → 0.15.3

package/src/apps/skimlinks.json

@@ -0,0 +1,48 @@
+{
+  "slug": "skimlinks",
+  "name": "Skimlinks",
+  "description": "Skimlinks publisher integration for deterministic Link Wrapper URL creation, plus placeholders for account-gated Merchant, Reporting, and Product Key API access.",
+  "logo": "https://www.google.com/s2/favicons?domain=skimlinks.com&sz=128",
+  "categories": ["affiliate", "publisher", "programs", "links", "stats", "marketing"],
+  "base_url": "https://go.skimresources.com",
+  "auth": {
+    "types": ["api_key"],
+    "query_params": {
+      "id": "{{site_id}}"
+    },
+    "credential_fields": [
+      {
+        "name": "site_id",
+        "label": "Skimlinks site ID",
+        "description": "Skimlinks Link Wrapper site ID, visible in Publisher Hub.",
+        "type": "text"
+      },
+      {
+        "name": "api_token",
+        "label": "API token",
+        "description": "Optional Skimlinks API token for Merchant/Reporting/Product Key APIs when enabled on the account.",
+        "type": "password",
+        "required": false
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "link_wrapper_url",
+      "description": "Build a Skimlinks long Link Wrapper URL for a destination. The tool returns the URL without fetching it, so it does not follow the merchant redirect.",
+      "method": "GET",
+      "path": "/",
+      "return_request_url": true,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "url": { "type": "string", "description": "Merchant destination URL." },
+          "xs": { "type": "integer", "default": 1 },
+          "xcust": { "type": "string", "description": "Optional CustomID for link-level reporting." },
+          "sref": { "type": "string", "description": "Optional source/referring page URL." }
+        },
+        "required": ["url"]
+      }
+    }
+  ]
+}

package/src/apps/slack.json

@@ -101,6 +101,19 @@
           "channel",
           "text"
         ]
+      },
+      "mock_response": {
+        "ok": true,
+        "channel": "C0EXAMPLE1",
+        "ts": "1747915200.123456",
+        "message": {
+          "type": "message",
+          "user": "U0BOT0001",
+          "ts": "1747915200.123456",
+          "text": "(message delivered)",
+          "team": "T0EXAMPLE",
+          "bot_id": "B0BOT0001"
+        }
       }
     },
     {
@@ -125,6 +138,9 @@
           "webhook_url",
           "text"
         ]
+      },
+      "mock_response": {
+        "ok": true
       }
     },
     {
@@ -145,6 +161,19 @@
         "required": [
           "name"
         ]
+      },
+      "mock_response": {
+        "ok": true,
+        "channel": {
+          "id": "C0NEW0001",
+          "name": "new-channel",
+          "is_channel": true,
+          "created": 1747915200,
+          "creator": "U0BOT0001",
+          "is_private": false,
+          "is_archived": false,
+          "num_members": 1
+        }
       }
     },
     {
@@ -162,6 +191,28 @@
             "type": "string"
           }
         }
+      },
+      "mock_response": {
+        "ok": true,
+        "members": [
+          {
+            "id": "U0ALICE01",
+            "name": "alice",
+            "real_name": "Alice Martin",
+            "is_bot": false,
+            "deleted": false
+          },
+          {
+            "id": "U0BOB0001",
+            "name": "bob",
+            "real_name": "Bob Nguyen",
+            "is_bot": false,
+            "deleted": false
+          }
+        ],
+        "response_metadata": {
+          "next_cursor": ""
+        }
       }
     },
     {
@@ -187,6 +238,9 @@
           "timestamp",
           "name"
         ]
+      },
+      "mock_response": {
+        "ok": true
       }
     },
     {
@@ -213,6 +267,18 @@
         "required": [
           "channels"
         ]
+      },
+      "mock_response": {
+        "ok": true,
+        "file": {
+          "id": "F0NEW0001",
+          "name": "upload.txt",
+          "title": "upload.txt",
+          "mimetype": "text/plain",
+          "filetype": "text",
+          "size": 1024,
+          "url_private": "https://files.slack.com/files-pri/T0EXAMPLE-F0NEW0001/upload.txt"
+        }
       }
     },
     {
@@ -240,6 +306,28 @@
             "maximum": 1000
           }
         }
+      },
+      "mock_response": {
+        "ok": true,
+        "channels": [
+          {
+            "id": "C0GENERAL",
+            "name": "general",
+            "is_channel": true,
+            "is_private": false,
+            "num_members": 42
+          },
+          {
+            "id": "C0RANDOM0",
+            "name": "random",
+            "is_channel": true,
+            "is_private": false,
+            "num_members": 31
+          }
+        ],
+        "response_metadata": {
+          "next_cursor": ""
+        }
       }
     },
     {
@@ -280,6 +368,19 @@
           "thread_ts",
           "text"
         ]
+      },
+      "mock_response": {
+        "ok": true,
+        "channel": "C0EXAMPLE1",
+        "ts": "1747915260.222333",
+        "message": {
+          "type": "message",
+          "user": "U0BOT0001",
+          "ts": "1747915260.222333",
+          "thread_ts": "1747915200.123456",
+          "text": "(reply delivered)",
+          "team": "T0EXAMPLE"
+        }
       }
     }
   ],

package/src/apps/smartlead.json

@@ -0,0 +1,146 @@
+{
+  "slug": "smartlead",
+  "name": "Smartlead",
+  "description": "Cold-email platform with unlimited mailboxes and built-in warmup. Often paired with or chosen over Instantly for higher-volume outbound.",
+  "logo": "https://www.google.com/s2/favicons?domain=smartlead.ai&sz=128",
+  "categories": ["email", "outreach", "sequencing", "campaigns", "sales", "cold-email"],
+  "base_url": "https://server.smartlead.ai/api/v1",
+  "auth": {
+    "types": ["api_key"],
+    "query_params": {
+      "api_key": "{{api_key}}"
+    },
+    "credential_fields": [
+      {
+        "name": "api_key",
+        "label": "API key",
+        "description": "Smartlead API key from app.smartlead.ai → Settings → API"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "list_campaigns",
+      "description": "List all campaigns.",
+      "method": "GET",
+      "path": "/campaigns",
+      "input_schema": { "type": "object", "properties": {} }
+    },
+    {
+      "name": "create_campaign",
+      "description": "Create a new campaign (empty shell — add mailboxes, sequence steps, leads in follow-up calls).",
+      "method": "POST",
+      "path": "/campaigns/create",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string" },
+          "client_id": { "type": "integer", "description": "Optional whitelabel/sub-account id" }
+        },
+        "required": ["name"]
+      }
+    },
+    {
+      "name": "save_sequence",
+      "description": "Save the email sequence (steps) for a campaign.",
+      "method": "POST",
+      "path": "/campaigns/{campaign_id}/sequences",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "campaign_id": { "type": "integer" },
+          "sequences": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "seq_number": { "type": "integer" },
+                "seq_delay_details": { "type": "object", "properties": { "delay_in_days": { "type": "integer" } } },
+                "subject": { "type": "string" },
+                "email_body": { "type": "string", "description": "HTML or text body" }
+              }
+            }
+          }
+        },
+        "required": ["campaign_id", "sequences"]
+      }
+    },
+    {
+      "name": "add_leads",
+      "description": "Add leads to a campaign.",
+      "method": "POST",
+      "path": "/campaigns/{campaign_id}/leads",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "campaign_id": { "type": "integer" },
+          "lead_list": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "first_name": { "type": "string" },
+                "last_name": { "type": "string" },
+                "email": { "type": "string" },
+                "company_name": { "type": "string" },
+                "phone_number": { "type": "string" },
+                "website": { "type": "string" },
+                "custom_fields": { "type": "object" }
+              },
+              "required": ["email"]
+            }
+          },
+          "settings": {
+            "type": "object",
+            "properties": {
+              "ignore_global_block_list": { "type": "boolean" },
+              "ignore_unsubscribe_list": { "type": "boolean" },
+              "ignore_duplicate_leads_in_other_campaign": { "type": "boolean" }
+            }
+          }
+        },
+        "required": ["campaign_id", "lead_list"]
+      }
+    },
+    {
+      "name": "update_campaign_status",
+      "description": "Start, pause, or stop a campaign.",
+      "method": "POST",
+      "path": "/campaigns/{campaign_id}/status",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "campaign_id": { "type": "integer" },
+          "status": { "type": "string", "enum": ["START", "PAUSED", "STOPPED"] }
+        },
+        "required": ["campaign_id", "status"]
+      }
+    },
+    {
+      "name": "campaign_analytics",
+      "description": "Get analytics for a campaign.",
+      "method": "GET",
+      "path": "/campaigns/{campaign_id}/analytics",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "campaign_id": { "type": "integer" }
+        },
+        "required": ["campaign_id"]
+      }
+    },
+    {
+      "name": "list_email_accounts",
+      "description": "List connected sending mailboxes.",
+      "method": "GET",
+      "path": "/email-accounts/",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "offset": { "type": "integer", "default": 0 },
+          "limit": { "type": "integer", "default": 100 }
+        }
+      }
+    }
+  ]
+}

package/src/apps/snapchat-ads.json

@@ -0,0 +1,238 @@
+{
+  "slug": "snapchat-ads",
+  "name": "Snapchat Ads",
+  "description": "Snap Marketing API — manage organizations, ad accounts, campaigns, ad squads (ad sets), ads, audiences, and pull stats for Snapchat advertising",
+  "logo": "https://www.google.com/s2/favicons?domain=ads.snapchat.com&sz=128",
+  "categories": [
+    "advertising",
+    "marketing",
+    "campaigns",
+    "social-ads",
+    "snapchat",
+    "video-ads",
+    "ar-ads"
+  ],
+  "base_url": "https://adsapi.snapchat.com/v1",
+  "auth": {
+    "types": [
+      "bearer",
+      "oauth2"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "access_token",
+        "type": "password"
+      },
+      {
+        "name": "refresh_token",
+        "label": "refresh_token",
+        "type": "password"
+      },
+      {
+        "name": "expires_in",
+        "label": "expires_in"
+      },
+      {
+        "name": "ad_account_id",
+        "label": "Default Ad Account ID",
+        "description": "UUID of default ad account"
+      }
+    ],
+    "oauth2": {
+      "authorize_url": "https://accounts.snapchat.com/login/oauth2/authorize",
+      "token_url": "https://accounts.snapchat.com/login/oauth2/access_token",
+      "scopes": [
+        "snapchat-marketing-api"
+      ],
+      "client_id_required": true,
+      "pkce": false
+    }
+  },
+  "tools": [
+    {
+      "name": "list_organizations",
+      "description": "List organizations the authenticated user belongs to. Each organization owns ad accounts and funding sources.",
+      "method": "GET",
+      "path": "/me/organizations",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "with_ad_accounts": { "type": "boolean", "default": false }
+        }
+      }
+    },
+    {
+      "name": "list_ad_accounts",
+      "description": "List ad accounts under an organization.",
+      "method": "GET",
+      "path": "/organizations/{organization_id}/adaccounts",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "organization_id": { "type": "string" },
+          "limit": { "type": "integer", "default": 50 },
+          "cursor": { "type": "string" }
+        },
+        "required": ["organization_id"]
+      }
+    },
+    {
+      "name": "list_campaigns",
+      "description": "List campaigns under an ad account.",
+      "method": "GET",
+      "path": "/adaccounts/{ad_account_id}/campaigns",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_account_id": { "type": "string" },
+          "limit": { "type": "integer", "default": 50 },
+          "cursor": { "type": "string" },
+          "read_deleted_entities": { "type": "boolean", "default": false }
+        },
+        "required": ["ad_account_id"]
+      }
+    },
+    {
+      "name": "create_campaign",
+      "description": "Create one or more campaigns. Body: {\"campaigns\": [{name, ad_account_id, status (ACTIVE|PAUSED), start_time (ISO8601), end_time?, objective (BRAND_AWARENESS|APP_INSTALL|VIDEO_VIEW|WEB_VIEW|WEB_CONVERSION|LEAD_GENERATION|APP_REENGAGEMENT|PROMOTE_PLACES|CATALOG_SALES|ENGAGEMENT), daily_budget_micro?, lifetime_spend_cap_micro?}]}.",
+      "method": "POST",
+      "path": "/adaccounts/{ad_account_id}/campaigns",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_account_id": { "type": "string" },
+          "campaigns": { "type": "array", "items": { "type": "object" } }
+        },
+        "required": ["ad_account_id", "campaigns"]
+      }
+    },
+    {
+      "name": "update_campaign",
+      "description": "Update one or more campaigns by id. Body: {\"campaigns\": [{id, ...fields to mutate}]}.",
+      "method": "PUT",
+      "path": "/adaccounts/{ad_account_id}/campaigns",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_account_id": { "type": "string" },
+          "campaigns": { "type": "array", "items": { "type": "object" } }
+        },
+        "required": ["ad_account_id", "campaigns"]
+      }
+    },
+    {
+      "name": "list_ad_squads",
+      "description": "List ad squads (Snap's ad-set abstraction) under a campaign or under an ad account.",
+      "method": "GET",
+      "path": "/campaigns/{campaign_id}/adsquads",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "campaign_id": { "type": "string" },
+          "limit": { "type": "integer", "default": 50 },
+          "cursor": { "type": "string" }
+        },
+        "required": ["campaign_id"]
+      }
+    },
+    {
+      "name": "create_ad_squad",
+      "description": "Create one or more ad squads under a campaign. Each requires name, campaign_id, type (SNAP_ADS|STORY|COLLECTION), targeting object, billing_event (IMPRESSION|SWIPES), bid_micro, daily_budget_micro, start_time, optimization_goal (IMPRESSIONS|SWIPES|APP_INSTALLS|VIDEO_VIEWS|VIDEO_VIEWS_15_SEC|PIXEL_PURCHASE|PIXEL_SIGNUP|...).",
+      "method": "POST",
+      "path": "/campaigns/{campaign_id}/adsquads",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "campaign_id": { "type": "string" },
+          "adsquads": { "type": "array", "items": { "type": "object" } }
+        },
+        "required": ["campaign_id", "adsquads"]
+      }
+    },
+    {
+      "name": "list_ads",
+      "description": "List ads under an ad squad.",
+      "method": "GET",
+      "path": "/adsquads/{ad_squad_id}/ads",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_squad_id": { "type": "string" },
+          "limit": { "type": "integer", "default": 50 },
+          "cursor": { "type": "string" }
+        },
+        "required": ["ad_squad_id"]
+      }
+    },
+    {
+      "name": "create_ad",
+      "description": "Create one or more ads under an ad squad. Each requires name, ad_squad_id, creative_id (pre-created creative), status, type (SNAP_AD|STORY_AD|COLLECTION_AD|...).",
+      "method": "POST",
+      "path": "/adsquads/{ad_squad_id}/ads",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_squad_id": { "type": "string" },
+          "ads": { "type": "array", "items": { "type": "object" } }
+        },
+        "required": ["ad_squad_id", "ads"]
+      }
+    },
+    {
+      "name": "list_creatives",
+      "description": "List creatives under an ad account.",
+      "method": "GET",
+      "path": "/adaccounts/{ad_account_id}/creatives",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_account_id": { "type": "string" },
+          "limit": { "type": "integer", "default": 50 },
+          "cursor": { "type": "string" }
+        },
+        "required": ["ad_account_id"]
+      }
+    },
+    {
+      "name": "campaign_stats",
+      "description": "Pull campaign performance stats. granularity: TOTAL|DAY|HOUR. fields: comma-separated metrics (impressions,swipes,spend,video_views,quartile_1/2/3,view_completion,saves,shares,screen_time_millis,conversion_purchases,conversion_sign_ups, etc.). Time window: start_time / end_time as ISO8601.",
+      "method": "GET",
+      "path": "/campaigns/{campaign_id}/stats",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "campaign_id": { "type": "string" },
+          "granularity": { "type": "string", "enum": ["TOTAL", "DAY", "HOUR"], "default": "DAY" },
+          "fields": { "type": "string", "description": "Comma-separated metric names" },
+          "start_time": { "type": "string" },
+          "end_time": { "type": "string" },
+          "swipe_up_attribution_window": { "type": "string", "enum": ["1_DAY", "7_DAY", "28_DAY"], "default": "28_DAY" },
+          "view_attribution_window": { "type": "string", "enum": ["1_HOUR", "3_HOUR", "6_HOUR", "1_DAY", "7_DAY"], "default": "1_DAY" }
+        },
+        "required": ["campaign_id"]
+      }
+    },
+    {
+      "name": "ad_account_stats",
+      "description": "Pull ad-account-level performance stats with the same granularity / fields / window options as campaign_stats.",
+      "method": "GET",
+      "path": "/adaccounts/{ad_account_id}/stats",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_account_id": { "type": "string" },
+          "granularity": { "type": "string", "enum": ["TOTAL", "DAY", "HOUR"], "default": "DAY" },
+          "fields": { "type": "string" },
+          "start_time": { "type": "string" },
+          "end_time": { "type": "string" },
+          "breakdown": { "type": "string", "description": "e.g. country, region, gender, age, os, placement" }
+        },
+        "required": ["ad_account_id"]
+      }
+    }
+  ]
+}

package/src/apps/snaprender.json

@@ -0,0 +1,64 @@
+{
+  "slug": "snaprender",
+  "name": "SnapRender",
+  "description": "Website screenshot API tailored for AI agents (Claude, ChatGPT, LangChain). POST a URL and receive the rendered image binary, or JSON with base64 + metadata. Cached responses don't count against quota. Supports PNG/JPEG/WebP/PDF, device emulation, dark mode, ad blocking. $29/mo for 10K screenshots.",
+  "logo": "https://www.google.com/s2/favicons?domain=snap-render.com&sz=128",
+  "categories": ["screenshots", "rendering", "automation", "ai"],
+  "base_url": "https://app.snap-render.com",
+  "auth": {
+    "types": ["api_key"],
+    "headers": {
+      "X-API-Key": "{{api_key}}"
+    },
+    "credential_fields": [
+      { "name": "api_key", "label": "SnapRender API key (sk_live_...)" }
+    ]
+  },
+  "tools": [
+    {
+      "name": "screenshot",
+      "description": "Capture a screenshot of a URL. Returns the image binary directly, or JSON metadata + base64 when `response_type=json`. Cached renders do not consume quota.",
+      "method": "POST",
+      "path": "/v1/screenshot",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "url": { "type": "string", "description": "The URL to screenshot" },
+          "format": { "type": "string", "enum": ["png", "jpeg", "webp", "pdf"], "default": "png" },
+          "response_type": { "type": "string", "enum": ["binary", "json"], "default": "binary", "description": "`json` returns metadata + base64 image instead of raw binary" },
+          "full_page": { "type": "boolean", "default": false },
+          "viewport_width": { "type": "integer", "default": 1280 },
+          "viewport_height": { "type": "integer", "default": 800 },
+          "device_scale_factor": { "type": "number", "default": 1, "description": "Pixel density (2 = retina)" },
+          "device": { "type": "string", "description": "Device preset to emulate (e.g. iphone_14, pixel_7)" },
+          "dark_mode": { "type": "boolean", "default": false },
+          "block_ads": { "type": "boolean", "default": false },
+          "block_cookie_banners": { "type": "boolean", "default": false },
+          "wait_until": { "type": "string", "enum": ["load", "domcontentloaded", "networkidle"], "default": "networkidle" },
+          "wait_for_selector": { "type": "string", "description": "CSS selector to wait for before capturing" },
+          "delay_ms": { "type": "integer", "description": "Extra delay in milliseconds before capturing" },
+          "selector": { "type": "string", "description": "Capture only the element matching this CSS selector" },
+          "user_agent": { "type": "string" },
+          "cache": { "type": "boolean", "default": true, "description": "Use cached render if available (doesn't consume quota)" },
+          "cache_ttl": { "type": "integer", "default": 3600 }
+        },
+        "required": ["url"]
+      }
+    },
+    {
+      "name": "screenshot_info",
+      "description": "Check whether a screenshot for the given URL + params is already cached, without triggering a new render. Useful for cost estimation.",
+      "method": "GET",
+      "path": "/v1/screenshot/info",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "url": { "type": "string" },
+          "format": { "type": "string", "enum": ["png", "jpeg", "webp", "pdf"], "default": "png" }
+        },
+        "required": ["url"]
+      },
+      "query_params": ["url", "format"]
+    }
+  ]
+}