manage-webhook

# Webhook Management

Manage webhooks in Sinch Conversation API using the Conversation API specification. Note: MCP tools do not provide webhook management tools, so this skill always uses the Conversation API endpoints. Webhooks receive callbacks for various events like message delivery, inbound messages, contact updates, and conversation events.

## Instructions

1. **Identify the operation from user request:**
   - **Create webhook**: New webhook with target URL and triggers
   - **Update webhook**: Modify webhook target, triggers, or secret
   - **List webhooks**: Retrieve webhooks for an app or project
   - **Get webhook**: Retrieve specific webhook details
   - **Delete webhook**: Remove a webhook

2. **Extract webhook information:**
   - Webhook ID: Unique identifier for existing webhooks
   - Target URL: The callback URL where webhooks will be sent
   - App ID: The app this webhook belongs to (required for creation)
   - Triggers: Array of webhook triggers (MESSAGE_DELIVERY, MESSAGE_INBOUND, CONTACT_CREATE, etc.)
   - Secret: Optional secret for signing webhook payloads
   - Target type: HTTP (default) or DISMISS

3. **Use Conversation API endpoints to perform operations:**
   - **Note**: MCP Sinch does not provide webhook management tools, so this skill always uses the Conversation API endpoints
   - **Create webhook**: `POST /v1/projects/{project_id}/webhooks` (Operation ID: `Webhooks_CreateWebhook`)
   - **Update webhook**: `PATCH /v1/projects/{project_id}/webhooks/{webhook_id}` (Operation ID: `Webhooks_UpdateWebhook`)
   - **Get webhook**: `GET /v1/projects/{project_id}/webhooks/{webhook_id}` (Operation ID: `Webhooks_GetWebhook`)
   - **List webhooks**: `GET /v1/projects/{project_id}/apps/{app_id}/webhooks` (Operation ID: `Webhooks_ListWebhooks`)
   - **Delete webhook**: `DELETE /v1/projects/{project_id}/webhooks/{webhook_id}` (Operation ID: `Webhooks_DeleteWebhook`)
   - Authentication: Use Basic Auth or OAuth2 with credentials from environment variable