@apteva/integrations 0.3.62 → 0.15.3

package/src/apps/stripe.json

@@ -794,6 +794,159 @@
         }
       }
     },
+    {
+      "name": "finalize_invoice",
+      "description": "Finalize a draft invoice. Mints an invoice number, generates the hosted_invoice_url, and (unless auto_advance is false) starts the collection process. Use when create_invoice was called with auto_advance=false.",
+      "method": "POST",
+      "path": "/invoices/{invoice_id}/finalize",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "invoice_id": {
+            "type": "string",
+            "description": "Invoice ID (in_xxx)"
+          },
+          "auto_advance": {
+            "type": "boolean",
+            "description": "Whether Stripe should advance the collection (email, charge) automatically after finalization. Set false to get the hosted_invoice_url without Stripe sending the email."
+          }
+        },
+        "required": [
+          "invoice_id"
+        ]
+      }
+    },
+    {
+      "name": "void_invoice",
+      "description": "Void an open invoice. Marks it permanently uncollectible from the customer's perspective. Use when our billing voids an invoice that was already mirrored to Stripe.",
+      "method": "POST",
+      "path": "/invoices/{invoice_id}/void",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "invoice_id": {
+            "type": "string",
+            "description": "Invoice ID (in_xxx)"
+          }
+        },
+        "required": [
+          "invoice_id"
+        ]
+      }
+    },
+    {
+      "name": "send_invoice",
+      "description": "Trigger Stripe to send the invoice email to the customer. Only works on invoices with collection_method=send_invoice. Returns the invoice with status_transitions.email_sent_at populated.",
+      "method": "POST",
+      "path": "/invoices/{invoice_id}/send",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "invoice_id": {
+            "type": "string",
+            "description": "Invoice ID (in_xxx)"
+          }
+        },
+        "required": [
+          "invoice_id"
+        ]
+      }
+    },
+    {
+      "name": "create_checkout_session",
+      "description": "Create a Stripe Checkout Session — a hosted payment page. Returns { id, url } where url is the Stripe-hosted page the customer is redirected to. mode=payment for one-time; mode=subscription for recurring (uses price IDs from create_price). Webhook event checkout.session.completed fires on payment success.",
+      "method": "POST",
+      "path": "/checkout/sessions",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "mode": {
+            "type": "string",
+            "description": "Checkout mode",
+            "enum": [
+              "payment",
+              "subscription",
+              "setup"
+            ],
+            "default": "payment"
+          },
+          "line_items": {
+            "type": "array",
+            "description": "Array of {price: 'price_xxx', quantity: N} for catalog prices, or {price_data: {...}, quantity: N} for ad-hoc lines."
+          },
+          "customer": {
+            "type": "string",
+            "description": "Existing Stripe customer ID (cus_xxx). Omit to let Stripe create or match by email."
+          },
+          "customer_email": {
+            "type": "string",
+            "description": "Pre-fill the buyer's email on the Stripe-hosted page."
+          },
+          "success_url": {
+            "type": "string",
+            "description": "URL Stripe redirects to after successful payment. May include {CHECKOUT_SESSION_ID} placeholder."
+          },
+          "cancel_url": {
+            "type": "string",
+            "description": "URL Stripe redirects to if the customer abandons the page."
+          },
+          "client_reference_id": {
+            "type": "string",
+            "description": "Free-form string returned in the webhook payload. Useful for tying back to your own session/cart id."
+          },
+          "metadata": {
+            "type": "object",
+            "description": "Arbitrary key-value pairs returned in webhook events."
+          },
+          "payment_intent_data": {
+            "type": "object",
+            "description": "Optional config applied to the underlying PaymentIntent (description, statement_descriptor, etc.)."
+          },
+          "subscription_data": {
+            "type": "object",
+            "description": "Only when mode=subscription — config for the resulting subscription (trial_period_days, metadata, etc.)."
+          },
+          "expires_at": {
+            "type": "integer",
+            "description": "Unix timestamp at which the session expires. Min 30 min from creation, max 24h."
+          }
+        },
+        "required": [
+          "line_items",
+          "success_url"
+        ]
+      }
+    },
+    {
+      "name": "create_payment_link",
+      "description": "Create a Stripe Payment Link — a reusable shareable URL that takes a customer to a hosted payment page. Unlike Checkout Sessions, Payment Links don't expire and can be shared multiple times. Useful for invoice 'pay this' links.",
+      "method": "POST",
+      "path": "/payment_links",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "line_items": {
+            "type": "array",
+            "description": "Array of {price: 'price_xxx', quantity: N}. Price IDs must already exist in Stripe (use create_price)."
+          },
+          "after_completion": {
+            "type": "object",
+            "description": "What to do after payment completes (e.g. {type: 'redirect', redirect: {url: '…'}}). Defaults to Stripe's success page."
+          },
+          "metadata": {
+            "type": "object",
+            "description": "Arbitrary key-value pairs returned in webhook events."
+          },
+          "payment_intent_data": {
+            "type": "object",
+            "description": "Optional config applied to the underlying PaymentIntents created for each customer."
+          }
+        },
+        "required": [
+          "line_items"
+        ]
+      }
+    },
     {
       "name": "list_charges",
       "description": "List charges with optional customer filter and pagination",

package/src/apps/target-circle.json

@@ -0,0 +1,348 @@
+{
+  "slug": "target-circle",
+  "name": "Target Circle (Circlewise)",
+  "description": "Target Circle Publisher API used by Circlewise publishers. Search available offers, fetch offer details and ads, generate tracking codes/deeplinks, and retrieve publisher performance reports.",
+  "logo": "https://www.google.com/s2/favicons?domain=targetcircle.com&sz=128",
+  "categories": [
+    "affiliate",
+    "publisher",
+    "offers",
+    "links",
+    "marketing",
+    "circlewise"
+  ],
+  "base_url": "https://api.targetcircle.com",
+  "auth": {
+    "types": [
+      "api_key"
+    ],
+    "headers": {
+      "X-Api-Token": "{{api_token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "api_token",
+        "label": "Publisher API token",
+        "description": "Target Circle / Circlewise publisher API token.",
+        "type": "password"
+      }
+    ]
+  },
+  "health_check": {
+    "tool": "offers_list",
+    "input": {
+      "limit": 1
+    },
+    "expect_status": [
+      200
+    ]
+  },
+  "tools": [
+    {
+      "name": "offers_list",
+      "description": "List available publisher offers/trades from Target Circle. The live v1 endpoint returns offers grouped by ad inventory. Supports filtering by offer, advertiser, status, ad inventory, provider, category, vertical, country, currency, start/end dates, and pagination.",
+      "method": "GET",
+      "path": "/api/v1/offers",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": {
+            "type": "integer",
+            "default": 50,
+            "description": "Maximum number of offer groups to return. Target Circle rejects values above 50.",
+            "maximum": 50
+          },
+          "offset": {
+            "type": "integer",
+            "default": 0,
+            "description": "Pagination offset."
+          },
+          "offerSid": {
+            "type": "string",
+            "description": "Offer slug/SID filter from the Target Circle tester."
+          },
+          "offerId": {
+            "type": "string",
+            "description": "Offer ID filter from the Publisher API docs."
+          },
+          "offerName": {
+            "type": "string",
+            "description": "Offer name filter. Comma-separated values mean OR."
+          },
+          "device": {
+            "type": "string",
+            "description": "Offer device filter."
+          },
+          "status": {
+            "type": "string",
+            "description": "Offer status filter, for example accepted."
+          },
+          "adInventoryName": {
+            "type": "string",
+            "description": "Ad inventory name filter."
+          },
+          "adInventorySid": {
+            "type": "string",
+            "description": "Ad inventory slug/SID filter."
+          },
+          "adInventory": {
+            "type": "string",
+            "description": "Ad inventory filter from the Publisher API docs."
+          },
+          "advertiser": {
+            "type": "string",
+            "description": "Advertiser filter. Comma-separated values mean OR."
+          },
+          "country": {
+            "type": "string",
+            "description": "Country filter. Comma-separated values mean OR."
+          },
+          "currency": {
+            "type": "string",
+            "description": "Currency code, for example EUR or USD."
+          },
+          "provider": {
+            "type": "string",
+            "description": "Provider filter. Comma-separated values mean OR."
+          },
+          "category": {
+            "type": "string",
+            "description": "Category filter. Comma-separated values mean OR."
+          },
+          "vertical": {
+            "type": "string",
+            "description": "Vertical filter. Comma-separated values mean OR."
+          },
+          "startDateFrom": {
+            "type": "string",
+            "description": "Start date lower bound."
+          },
+          "startDateTo": {
+            "type": "string",
+            "description": "Start date upper bound."
+          },
+          "endDateFrom": {
+            "type": "string",
+            "description": "End date lower bound."
+          },
+          "endDateTo": {
+            "type": "string",
+            "description": "End date upper bound."
+          }
+        }
+      }
+    },
+    {
+      "name": "offer_get",
+      "description": "Fetch one offer by slug/SID, including provider, advertiser, ad inventories, tracking/deeplinking settings, policies, target countries, and target URL.",
+      "method": "GET",
+      "path": "/api/v1/offers/{slug}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "slug": {
+            "type": "string",
+            "description": "Offer slug/SID."
+          }
+        },
+        "required": [
+          "slug"
+        ]
+      }
+    },
+    {
+      "name": "offer_ads_list",
+      "description": "List text and banner ads for an offer. Use together with codes_list type filters when you need specific ad assets.",
+      "method": "GET",
+      "path": "/api/v1/offers/{slug}/ads",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "slug": {
+            "type": "string",
+            "description": "Offer slug/SID."
+          }
+        },
+        "required": [
+          "slug"
+        ]
+      }
+    },
+    {
+      "name": "codes_list",
+      "description": "Generate/list tracking codes and click URLs for an offer/ad inventory, optionally with a deeplink and tracking parameters. The live API requires at least one parameters[...] query value, such as parameters[ref1] or parameters[source_id].",
+      "method": "GET",
+      "path": "/api/v1/codes",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": {
+            "type": "integer",
+            "default": 50,
+            "description": "Maximum number of codes to return."
+          },
+          "offerSid": {
+            "type": "string",
+            "description": "Offer slug/SID from the official tester."
+          },
+          "offerId": {
+            "type": "string",
+            "description": "Offer ID from the Publisher API docs."
+          },
+          "adInventorySid": {
+            "type": "string",
+            "description": "Ad inventory slug/SID from the official tester."
+          },
+          "adInventory": {
+            "type": "string",
+            "description": "Ad inventory identifier from the Publisher API docs."
+          },
+          "deeplink": {
+            "type": "string",
+            "description": "Optional destination URL to deep-link to when the offer permits deeplinking."
+          },
+          "parameters[idfa]": {
+            "type": "string",
+            "description": "iOS advertising identifier tracking parameter."
+          },
+          "parameters[gaid]": {
+            "type": "string",
+            "description": "Google advertising identifier tracking parameter."
+          },
+          "parameters[waid]": {
+            "type": "string",
+            "description": "Windows advertising identifier tracking parameter."
+          },
+          "parameters[click_id]": {
+            "type": "string",
+            "description": "External click ID tracking parameter."
+          },
+          "parameters[source_id]": {
+            "type": "string",
+            "description": "External source ID tracking parameter."
+          },
+          "parameters[ref1]": {
+            "type": "string",
+            "description": "Publisher reference/sub ID 1. Include at least one parameters[...] value; the live API returns 500 when the parameters object is omitted."
+          },
+          "parameters[ref2]": {
+            "type": "string",
+            "description": "Publisher reference/sub ID 2."
+          },
+          "parameters[ref3]": {
+            "type": "string",
+            "description": "Publisher reference/sub ID 3."
+          },
+          "parameters[ref4]": {
+            "type": "string",
+            "description": "Publisher reference/sub ID 4."
+          },
+          "parameters[ref5]": {
+            "type": "string",
+            "description": "Publisher reference/sub ID 5."
+          },
+          "type": {
+            "type": "string",
+            "description": "Ad/code type, for example text or banner."
+          },
+          "maxHeight": {
+            "type": "integer",
+            "description": "Maximum banner height."
+          },
+          "minHeight": {
+            "type": "integer",
+            "description": "Minimum banner height."
+          },
+          "maxWidth": {
+            "type": "integer",
+            "description": "Maximum banner width."
+          },
+          "minWidth": {
+            "type": "integer",
+            "description": "Minimum banner width."
+          },
+          "maxSize": {
+            "type": "integer",
+            "description": "Maximum banner file size."
+          },
+          "minSize": {
+            "type": "integer",
+            "description": "Minimum banner file size."
+          }
+        }
+      }
+    },
+    {
+      "name": "transactions_list",
+      "description": "List transactions from the live Target Circle publisher tester endpoint. Filter by currency, saved date range, offer/ad inventory, country, transaction type, conversion status, reference, and sort options.",
+      "method": "GET",
+      "path": "/api/v1/transactions",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": {
+            "type": "integer",
+            "default": 25,
+            "description": "Maximum number of transactions to return. The live publisher endpoint is documented/tested with a maximum of 25.",
+            "maximum": 25
+          },
+          "offset": {
+            "type": "integer",
+            "default": 0,
+            "description": "Pagination offset."
+          },
+          "currency": {
+            "type": "string",
+            "description": "Currency code, for example EUR."
+          },
+          "savedFrom": {
+            "type": "string",
+            "description": "Saved date lower bound, for example 2026-05-01."
+          },
+          "savedTo": {
+            "type": "string",
+            "description": "Saved date upper bound, for example 2026-05-25."
+          },
+          "offerSid": {
+            "type": "string",
+            "description": "Offer slug/SID."
+          },
+          "adInventorySid": {
+            "type": "string",
+            "description": "Ad inventory slug/SID."
+          },
+          "country": {
+            "type": "string",
+            "description": "Country filter. Comma-separated values mean OR."
+          },
+          "type": {
+            "type": "string",
+            "description": "Transaction type IDs. The official tester describes 1 sale, 2 lead, 3 install, 4 click, 5 impression."
+          },
+          "status": {
+            "type": "string",
+            "description": "Conversion status IDs. The official tester describes 1 pending, 2 failed, 3 approved, 4 declined, 5 approved/invoiced, 6 approved/paid in, 7 approved/paid out."
+          },
+          "reference": {
+            "type": "string",
+            "description": "Reference filter over ref1-ref5."
+          },
+          "sort": {
+            "type": "string",
+            "description": "Sort field."
+          },
+          "sortDir": {
+            "type": "string",
+            "enum": [
+              "ASC",
+              "DESC",
+              "asc",
+              "desc"
+            ],
+            "description": "Sort direction."
+          }
+        }
+      }
+    }
+  ]
+}

package/src/apps/tavily.json

@@ -0,0 +1,104 @@
+{
+  "slug": "tavily",
+  "name": "Tavily",
+  "description": "AI-native web search and content-extraction API designed for LLM agents. Returns ranked results with summaries; can fetch and clean full page content. Great for open-ended prospection ('find SaaS companies that mention switching from manual workflows').",
+  "logo": "https://www.google.com/s2/favicons?domain=tavily.com&sz=128",
+  "categories": ["search", "web", "ai", "research", "extraction", "prospecting"],
+  "base_url": "https://api.tavily.com",
+  "auth": {
+    "types": ["bearer"],
+    "headers": {
+      "Authorization": "Bearer {{api_key}}"
+    },
+    "credential_fields": [
+      {
+        "name": "api_key",
+        "label": "API key (starts with tvly-)",
+        "description": "Tavily API key from app.tavily.com → API Keys"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "search",
+      "description": "Run an AI-optimised web search. Returns ranked results with title, URL, content snippet, and an LLM-generated answer if requested. Use for ICP discovery, competitive scans, and intent research.",
+      "method": "POST",
+      "path": "/search",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "query": { "type": "string", "description": "Search query (max ~400 chars)" },
+          "search_depth": { "type": "string", "enum": ["basic", "advanced"], "default": "basic", "description": "'advanced' costs more credits but does deeper crawling" },
+          "topic": { "type": "string", "enum": ["general", "news", "finance"], "default": "general" },
+          "max_results": { "type": "integer", "default": 5, "minimum": 1, "maximum": 20 },
+          "time_range": { "type": "string", "enum": ["day", "week", "month", "year"], "description": "Restrict to recently-indexed results" },
+          "days": { "type": "integer", "description": "For topic='news': only results from last N days" },
+          "include_answer": { "type": "boolean", "default": false, "description": "Include an LLM-generated answer summarizing the results" },
+          "include_raw_content": { "type": "boolean", "default": false, "description": "Include full cleaned text of each result page" },
+          "include_images": { "type": "boolean", "default": false },
+          "include_domains": { "type": "array", "items": { "type": "string" }, "description": "Only return results from these domains" },
+          "exclude_domains": { "type": "array", "items": { "type": "string" } },
+          "country": { "type": "string", "description": "ISO country code to bias localized results" }
+        },
+        "required": ["query"]
+      }
+    },
+    {
+      "name": "extract",
+      "description": "Fetch one or more URLs and return cleaned page content optimized for LLM consumption. Use after a search to pull deeper context from selected pages.",
+      "method": "POST",
+      "path": "/extract",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "urls": { "type": "array", "items": { "type": "string" }, "description": "URLs to fetch (1–20 per call)" },
+          "extract_depth": { "type": "string", "enum": ["basic", "advanced"], "default": "basic" },
+          "include_images": { "type": "boolean", "default": false },
+          "format": { "type": "string", "enum": ["markdown", "text"], "default": "markdown" }
+        },
+        "required": ["urls"]
+      }
+    },
+    {
+      "name": "crawl",
+      "description": "Crawl a website starting from a seed URL and return cleaned content for matching pages. Use for site-wide research ('what does this company say about AI').",
+      "method": "POST",
+      "path": "/crawl",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "url": { "type": "string", "description": "Seed URL" },
+          "max_depth": { "type": "integer", "default": 1 },
+          "max_breadth": { "type": "integer", "default": 20 },
+          "limit": { "type": "integer", "default": 50, "description": "Max pages total" },
+          "instructions": { "type": "string", "description": "Natural-language hints for what to keep/skip" },
+          "select_paths": { "type": "array", "items": { "type": "string" }, "description": "Regex of pathnames to include" },
+          "exclude_paths": { "type": "array", "items": { "type": "string" } },
+          "allow_external": { "type": "boolean", "default": false },
+          "format": { "type": "string", "enum": ["markdown", "text"], "default": "markdown" }
+        },
+        "required": ["url"]
+      }
+    },
+    {
+      "name": "map",
+      "description": "Discover the URL graph of a site without fetching content. Returns the list of reachable URLs from a seed.",
+      "method": "POST",
+      "path": "/map",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "url": { "type": "string" },
+          "max_depth": { "type": "integer", "default": 1 },
+          "max_breadth": { "type": "integer", "default": 20 },
+          "limit": { "type": "integer", "default": 50 },
+          "instructions": { "type": "string" },
+          "select_paths": { "type": "array", "items": { "type": "string" } },
+          "exclude_paths": { "type": "array", "items": { "type": "string" } },
+          "allow_external": { "type": "boolean", "default": false }
+        },
+        "required": ["url"]
+      }
+    }
+  ]
+}