@apteva/integrations 0.3.9 → 0.3.11

package/src/apps/sendgrid-email.json

@@ -269,24 +269,6 @@
         "name": "email.unsubscribe",
         "description": "Recipient unsubscribed"
       }
-    ],
-    "registration": {
-      "method": "PATCH",
-      "path": "/user/webhooks/event/settings",
-      "url_field": "url",
-      "extra": {
-        "enabled": true,
-        "bounce": true,
-        "click": true,
-        "deferred": true,
-        "delivered": true,
-        "dropped": true,
-        "open": true,
-        "processed": true,
-        "spam_report": true,
-        "unsubscribe": true
-      },
-      "list_path": "/user/webhooks/event/settings"
-    }
+    ]
   }
 }

package/src/apps/shopify.json

@@ -1281,21 +1281,6 @@
         "name": "app/uninstalled",
         "description": "App uninstalled from store"
       }
-    ],
-    "registration": {
-      "method": "POST",
-      "path": "/webhooks.json",
-      "url_field": "webhook.address",
-      "extra": {
-        "webhook": {
-          "format": "json"
-        }
-      },
-      "id_field": "webhook.id",
-      "delete_path": "/webhooks/{id}.json",
-      "delete_method": "DELETE",
-      "list_path": "/webhooks.json",
-      "list_field": "webhooks"
-    }
+    ]
   }
 }

package/src/apps/slack.json

@@ -314,9 +314,6 @@
         "name": "team.join",
         "description": "New user joined workspace"
       }
-    ],
-    "registration": {
-      "manual_setup": "Go to api.slack.com/apps > Your App > Event Subscriptions to register your webhook URL. Slack requires app-level configuration, not API calls."
-    }
+    ]
   }
 }

package/src/apps/socialcast.json

@@ -1,7 +1,7 @@
 {
   "slug": "socialcast",
   "name": "SocialCast",
-  "description": "Unified social media posting platform \u2014 connect accounts across 9 platforms and publish everywhere at once",
+  "description": "Unified social media posting platform — connect accounts across 9 platforms and publish everywhere at once",
   "logo": "https://socialcast.dev/favicon-192.png",
   "categories": [
     "social-media",
@@ -35,7 +35,7 @@
   "tools": [
     {
       "name": "list_accounts",
-      "description": "List all connected social media accounts for the project. Optionally filter by platform or status. Accounts with status 'active' are fully configured and ready to post \u2014 do NOT suggest setup steps for active accounts. The platform_metadata field contains internal IDs used by the system (pageId, instagramAccountId, etc.) and should not be interpreted as incomplete setup.",
+      "description": "List all connected social media accounts for the project. Optionally filter by platform or status. Accounts with status 'active' are fully configured and ready to post — do NOT suggest setup steps for active accounts. The platform_metadata field contains internal IDs used by the system (pageId, instagramAccountId, etc.) and should not be interpreted as incomplete setup.",
       "method": "GET",
       "path": "/accounts",
       "input_schema": {
@@ -205,7 +205,7 @@
     },
     {
       "name": "create_post",
-      "description": "Create and publish a post to one or more connected social media platforms simultaneously. Supports text, images, videos, and links. To schedule a post for later, set scheduled_for to an ISO 8601 timestamp and optionally timezone (e.g., 'America/New_York'). Platform-specific overrides allow customizing content per platform (e.g., Reddit title, YouTube description, TikTok privacy).",
+      "description": "Create and publish a post to one or more connected social media platforms simultaneously. Supports text, images, videos, and links.\n\nMedia capabilities per platform:\n- Instagram: Single image, single video (Reel), or CAROUSEL (2-10 images/videos mixed). Pass multiple items in media_urls for carousel.\n- Facebook: Text, single image, MULTI-PHOTO (2+ images posted as album), single video, or link post.\n- Twitter/X: Text with up to 4 media attachments (images, GIFs, or 1 video). Media is uploaded automatically.\n- TikTok: Single video or PHOTO CAROUSEL (up to 35 images). Use overrides for privacy, comments, music.\n- YouTube: Single video upload with title, description, tags, privacy.\n- Pinterest: Single image with title, description, board, and link.\n- Reddit: Text (self) or link post to a subreddit.\n- LinkedIn: Text post with optional visibility setting.\n- Telegram: Text or single image with optional parse mode.\n\nTo schedule a post for later, set scheduled_for to an ISO 8601 timestamp and optionally timezone (e.g., 'America/New_York').",
       "method": "POST",
       "path": "/posts",
       "input_schema": {
@@ -217,7 +217,7 @@
           },
           "media_urls": {
             "type": "array",
-            "description": "Media attachments \u2014 array of objects with url, type (image/video), and optional alt_text",
+            "description": "Media attachments. Pass multiple images for carousel/album posts (Instagram up to 10, Facebook unlimited, TikTok up to 35). Each item needs url, type (image/video), and optional alt_text.",
             "items": {
               "type": "object",
               "properties": {
@@ -266,7 +266,7 @@
           },
           "platform_overrides": {
             "type": "object",
-            "description": "Per-platform overrides keyed by platform name. Only include platforms you want to customize. Available fields per platform: youtube: {title, description, tags (array), privacyStatus (public/unlisted/private), categoryId (default 22=People & Blogs)}. reddit: {title, subreddit, text, nsfw}. pinterest: {title, description, board_id}. tiktok: {title, text, privacyLevel}. linkedin: {text, visibility}. facebook: {text, title (video only)}. twitter: {text}. instagram: {text}. telegram: {text, chatId, parseMode}. All fields are optional \u2014 omitted fields fall back to the main post text.",
+            "description": "Per-platform overrides keyed by platform name. Only include platforms you want to customize. Available fields per platform: youtube: {title, description, tags (array), privacyStatus (public/unlisted/private), categoryId}. reddit: {title, subreddit, text, nsfw}. pinterest: {title, description, board_id}. tiktok: {title, text, privacyLevel (PUBLIC_TO_EVERYONE/MUTUAL_FOLLOW_FRIENDS/FOLLOWER_OF_CREATOR/SELF_ONLY), disableComment (bool), autoAddMusic (bool)}. linkedin: {text, visibility}. facebook: {text, title (video only)}. twitter: {text}. instagram: {text}. telegram: {text, chatId, parseMode}. All fields are optional — omitted fields fall back to the main post text.",
             "properties": {
               "twitter": {
                 "type": "object"
@@ -447,7 +447,7 @@
     },
     {
       "name": "get_post_analytics",
-      "description": "Fetch analytics and engagement metrics for a published post across all platforms. Returns impressions, reach, likes, comments, shares, views, saves, and clicks where available. Supported: Instagram, Facebook, YouTube, TikTok, Pinterest. No analytics API: Twitter, LinkedIn, Reddit, Telegram.",
+      "description": "Fetch analytics and engagement metrics for a published post across all platforms. Returns impressions, reach, likes, comments, shares, views, saves, clicks, quotes, and bookmarks where available. Supported: Instagram, Facebook, YouTube, TikTok, Pinterest, Twitter/X. No analytics API: LinkedIn, Reddit, Telegram.",
       "method": "GET",
       "path": "/posts/%7B%7Bid%7D%7D/analytics",
       "input_schema": {
@@ -463,6 +463,42 @@
         ]
       }
     },
+    {
+      "name": "account_insights",
+      "description": "Get page-level insights and historical stats for a connected social account. Returns follower growth, reach, impressions, engagement metrics, and top content over a date range. Supported: Instagram (reach, followers, engagement, interactions), Facebook (page impressions, reach, engagement, fans), YouTube (subscribers, views, watch time), TikTok (followers, views, likes, shares), Twitter/X (followers, following, tweet count + recent tweet engagement), Pinterest (impressions, engagement, pin clicks, outbound clicks, saves + top pins). Unsupported: LinkedIn, Reddit, Telegram.",
+      "method": "GET",
+      "path": "/accounts/%7B%7Bid%7D%7D/insights",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer",
+            "description": "Social account ID to get insights for"
+          },
+          "start_date": {
+            "type": "string",
+            "description": "Start date in YYYY-MM-DD format (defaults to 7 days ago)"
+          },
+          "end_date": {
+            "type": "string",
+            "description": "End date in YYYY-MM-DD format (defaults to today)"
+          },
+          "period": {
+            "type": "string",
+            "enum": [
+              "day",
+              "week",
+              "days_28"
+            ],
+            "description": "Aggregation period (Instagram/Facebook only)",
+            "default": "day"
+          }
+        },
+        "required": [
+          "id"
+        ]
+      }
+    },
     {
       "name": "account_health",
       "description": "Check the connection health of one or all connected social accounts. Verifies that OAuth tokens are still valid by calling each platform's profile API. Pass a specific account ID or 'all' to check all active accounts.",
@@ -481,7 +517,7 @@
     },
     {
       "name": "list_inbox",
-      "description": "List social inbox items \u2014 comments, replies, and DMs received on your connected accounts. Filter by platform, account, status, or type. Returns items sorted by most recent first with unread count.",
+      "description": "List social inbox items — comments, replies, and DMs received on your connected accounts. Filter by platform, account, status, or type. Returns items sorted by most recent first with unread count.",
       "method": "GET",
       "path": "/inbox",
       "input_schema": {
@@ -604,7 +640,7 @@
     },
     {
       "name": "update_inbox",
-      "description": "Update the status of inbox items \u2014 mark as read, replied, or archived. Supports single item, bulk IDs, or mark-all-read for an account.",
+      "description": "Update the status of inbox items — mark as read, replied, or archived. Supports single item, bulk IDs, or mark-all-read for an account.",
       "method": "PUT",
       "path": "/inbox",
       "input_schema": {
@@ -637,7 +673,7 @@
           },
           "social_account_id": {
             "type": "integer",
-            "description": "Filter for mark_all_read \u2014 only mark items from this account"
+            "description": "Filter for mark_all_read — only mark items from this account"
           }
         }
       }
@@ -693,9 +729,6 @@
         "name": "social.comment.deleted",
         "description": "A comment was removed from a post"
       }
-    ],
-    "registration": {
-      "manual_setup": "Configure webhooks in the SocialCast dashboard settings."
-    }
+    ]
   }
 }

package/src/apps/stripe-payments.json

@@ -895,18 +895,6 @@
         "name": "charge.refunded",
         "description": "Occurs when a charge is refunded"
       }
-    ],
-    "registration": {
-      "method": "POST",
-      "path": "/webhook_endpoints",
-      "url_field": "url",
-      "events_field": "enabled_events",
-      "content_type": "application/x-www-form-urlencoded",
-      "id_field": "id",
-      "delete_path": "/webhook_endpoints/{id}",
-      "delete_method": "DELETE",
-      "list_path": "/webhook_endpoints",
-      "list_field": "data"
-    }
+    ]
   }
 }

package/src/apps/stripe.json

@@ -573,18 +573,6 @@
         "name": "charge.refunded",
         "description": "Occurs when a charge is refunded"
       }
-    ],
-    "registration": {
-      "method": "POST",
-      "path": "/webhook_endpoints",
-      "url_field": "url",
-      "events_field": "enabled_events",
-      "content_type": "application/x-www-form-urlencoded",
-      "id_field": "id",
-      "delete_path": "/webhook_endpoints/{id}",
-      "delete_method": "DELETE",
-      "list_path": "/webhook_endpoints",
-      "list_field": "data"
-    }
+    ]
   }
 }

package/src/apps/twilio.json

@@ -1,7 +1,7 @@
 {
   "slug": "twilio",
   "name": "Twilio",
-  "description": "Twilio communications platform \u2014 SMS, MMS, voice calls, WhatsApp, phone numbers, recordings, usage, and verification",
+  "description": "Twilio communications platform — SMS, MMS, voice calls, WhatsApp, phone numbers, recordings, usage, and verification",
   "logo": "https://www.google.com/s2/favicons?domain=twilio.com&sz=128",
   "categories": [
     "messaging",
@@ -133,7 +133,7 @@
               "whatsapp"
             ],
             "default": "whatsapp",
-            "description": "Channel type \u2014 must be 'whatsapp'"
+            "description": "Channel type — must be 'whatsapp'"
           }
         },
         "required": [
@@ -320,7 +320,7 @@
     },
     {
       "name": "update_call",
-      "description": "Modify an in-progress call \u2014 redirect to new TwiML, end the call, or pause/resume recording.",
+      "description": "Modify an in-progress call — redirect to new TwiML, end the call, or pause/resume recording.",
       "method": "POST",
       "path": "/Accounts/%7B%7Bcredential.account_sid%7D%7D/Calls/%7B%7BCallSid%7D%7D.json",
       "input_schema": {
@@ -408,7 +408,7 @@
     },
     {
       "name": "update_phone_number",
-      "description": "Update configuration for a phone number \u2014 webhooks, friendly name, voice/SMS settings.",
+      "description": "Update configuration for a phone number — webhooks, friendly name, voice/SMS settings.",
       "method": "POST",
       "path": "/Accounts/%7B%7Bcredential.account_sid%7D%7D/IncomingPhoneNumbers/%7B%7BPhoneNumberSid%7D%7D.json",
       "input_schema": {
@@ -624,7 +624,7 @@
     },
     {
       "name": "get_usage",
-      "description": "Retrieve usage records for your account \u2014 see costs per category (calls, SMS, numbers, etc.).",
+      "description": "Retrieve usage records for your account — see costs per category (calls, SMS, numbers, etc.).",
       "method": "GET",
       "path": "/Accounts/%7B%7Bcredential.account_sid%7D%7D/Usage/Records.json",
       "input_schema": {
@@ -668,7 +668,7 @@
     },
     {
       "name": "get_whatsapp_sender",
-      "description": "Get details of a specific WhatsApp Business sender by SID \u2014 status, phone number, profile info, and capabilities.",
+      "description": "Get details of a specific WhatsApp Business sender by SID — status, phone number, profile info, and capabilities.",
       "method": "GET",
       "path": "/v2/Channels/Senders/%7B%7BSenderSid%7D%7D",
       "input_schema": {
@@ -795,7 +795,7 @@
     },
     {
       "name": "get_content_template",
-      "description": "Retrieve details of a specific content template by SID \u2014 body, variables, type, and approval status.",
+      "description": "Retrieve details of a specific content template by SID — body, variables, type, and approval status.",
       "method": "GET",
       "path": "/v1/Content/%7B%7BContentSid%7D%7D",
       "input_schema": {
@@ -897,7 +897,7 @@
     },
     {
       "name": "lookup_phone_number",
-      "description": "Look up information about a phone number \u2014 carrier, caller name, line type (mobile/landline/voip).",
+      "description": "Look up information about a phone number — carrier, caller name, line type (mobile/landline/voip).",
       "method": "GET",
       "path": "/v2/PhoneNumbers/%7B%7BPhoneNumber%7D%7D",
       "input_schema": {
@@ -1052,9 +1052,6 @@
         "name": "recording.completed",
         "description": "Call recording ready"
       }
-    ],
-    "registration": {
-      "manual_setup": "Twilio webhooks are configured per-phone-number. Go to Twilio Console > Phone Numbers > Your Number to set the webhook URL for SMS/Voice."
-    }
+    ]
   }
 }

package/src/apps/typeform.json

@@ -214,9 +214,6 @@
         "name": "form_response",
         "description": "New form response submitted"
       }
-    ],
-    "registration": {
-      "manual_setup": "Go to your Typeform form > Connect > Webhooks to register your webhook URL."
-    }
+    ]
   }
 }