Create a webhook subscription
create_webhook_subscriptionCreate a signed webhook subscription to receive selected Upload-Post events at a public URL, with preview-before-confirmation approval.
Instructions
Add a destination that receives the listed events (besides the account webhook), signed like the account webhook (X-Upload-Post-Signature with the account's webhook secret, plus X-Upload-Post-Subscription: ). Idempotent: the same url + events + profile_username returns the existing subscription (created: false) and reactivates it if it was disabled (reactivated: true); name and source are updated when sent. The first delivery can take about a minute; failed deliveries are retried and show up in list_webhook_deliveries. At most 10 active subscriptions per account (409 subscription_limit_reached). Team members cannot create them (403 team_member_forbidden). Events: upload_completed, social_account_connected, social_account_disconnected, social_account_reauth_required, dm_received, comment_received, telegram_update, review_received, review_updated, customer_media_received, listing_google_update, listing_duplicate, listing_control_changed, post_analytics_updated; also youtube_video_published / youtube_video_updated and the post approval events (post_approval_requested, post_approved, post_rejected, post_approval_expired) while those features are on. Not generally available yet: until webhook subscriptions are switched on for the account, every call answers 503 with reason webhook_subscriptions_disabled (the feature is off, not a temporary failure). Needs the user's approval: call it first without confirmed to get a preview (nothing is sent), show the user exactly what will go out, and repeat the call with confirmed: true only after they approve.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>",
"events": "<events>"
},
"name": "create_webhook_subscription"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public https URL that will receive the events. | |
| name | No | Free label shown in the dashboard. | |
| events | Yes | Event names, e.g. ['upload_completed', 'comment_received']. | |
| source | No | Label of the integration creating it (a-z, 0-9, _ . -), e.g. 'n8n'. | |
| confirmed | No | Set to true only after the user has seen the preview this tool returns without it and approved it. Without it nothing is sent. | |
| profile_username | No | Only events of this Upload-Post profile. Without it: every profile of the account. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No |