Manage webhook settings
manage_webhook_settingsConfigure, preview, test, or remove account and per-profile webhook URLs and events for Upload-Post, so you can control where upload and social notifications are sent.
Instructions
The account webhook (one URL that gets the account's events) and per-profile webhooks (a profile sending its events to its own URL instead). The signing secret is never returned: responses only say webhook_secret_set, and the user sees or rotates it in the dashboard. get_account: current notification settings (channels {webhook, telegram}, webhook_url, webhook_events, telegram_chat_id). set_account: change only the fields sent (webhook_url, webhook_events, channels, telegram_chat_id); the first URL saved creates the signing secret. remove_account: clears webhook_url, webhook_events and the secret and turns the webhook channel off (webhook subscriptions keep working). test_account: sends a sample upload_completed through the configured channels (params: platform, media_type, title, caption, profile_username), logged as a test delivery. get_profile / set_profile (webhook_url; webhook_events {event: true|false}, omitted = every event, null = back to every event) / remove_profile (its events go back to the account webhook): need profile_username. webhook_events names: upload_completed, social_account_connected, social_account_disconnected, social_account_reauth_required, dm_received, comment_received and the others listed in create_webhook_subscription. Team members cannot change where the owner's events go (403). 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": {
"action": "<action>"
},
"name": "manage_webhook_settings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | ||
| params | No | Other fields with the API's names: set_account channels {webhook: bool, telegram: bool} and telegram_chat_id; test_account platform, media_type, title, caption, profile_username. | |
| 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. | |
| webhook_url | No | set_account / set_profile: public https URL that receives the events. | |
| webhook_events | No | set_account: list of event names (omitted = every event). set_profile: {event: true|false}, or null to go back to every event. | |
| profile_username | No | get_profile / set_profile / remove_profile: the Upload-Post profile. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No |