sinch-api-webhooks-create

Creates a webhook for a Sinch Conversation API app with triggers and secret.

6|2|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/sinch/sinch-plugins --skill sinch-api-webhooks-create-sinch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sinch-api-webhooks-create
Source: https://github.com/sinch/sinch-plugins/tree/main/plugins/sinch-antigravity-plugin/skills/sinch-api-webhooks-create
Command: npx skills add https://github.com/sinch/sinch-plugins --skill sinch-api-webhooks-create-sinch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up real-time event notifications for a Sinch Conversation API app requires manual API calls with OAuth2 authentication, correct request bodies, and valid trigger names. This Skill performs the webhook creation directly, including validation, duplicate detection, and secret generation. ## Core Features & Use Cases - Webhook Creation: Registers a new HTTPS webhook endpoint with selected event triggers via the Sinch Conversation API. - Validation & Duplicate Detection: Validates target URLs and trigger names, and checks whether a webhook with the same target already exists before creating. - Secret Management: Accepts a custom webhook secret or auto-generates one for request signature validation. - Use Case: You want delivery receipts and inbound messages pushed to your server. Run the command with your HTTPS endpoint and the MESSAGE_DELIVERY and MESSAGE_INBOUND triggers, and the webhook is live immediately. ## Quick Start Ask the assistant to create a Sinch webhook pointing to your HTTPS endpoint with the MESSAGE_DELIVERY and MESSAGE_INBOUND triggers.

Frequently Asked Questions about sinch-api-webhooks-create

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a webhook for the Sinch Conversation API?

Provide an HTTPS target URL and a comma-separated list of event triggers. The Skill calls POST /v1/projects/{projectId}/webhooks with OAuth2 authentication and returns the webhook ID, target, triggers, and secret.

What triggers are available for Sinch Conversation webhooks?

Available triggers include MESSAGE_DELIVERY, MESSAGE_INBOUND, MESSAGE_SUBMIT, EVENT_INBOUND, CONVERSATION_START, CONTACT_CREATE, OPT_IN, OPT_OUT, CAPABILITY, and others. You can combine multiple triggers on a single webhook.

What credentials does the Sinch webhook API require?

It requires CONVERSATION_PROJECT_ID, CONVERSATION_REGION, CONVERSATION_APP_ID, CONVERSATION_KEY_ID, and CONVERSATION_KEY_SECRET environment variables, or an active Sinch MCP configuration. Missing values produce a configuration error message.

Why does my Sinch webhook target URL get rejected?

The target must be a valid, publicly accessible HTTPS URL. Plain HTTP endpoints or malformed URLs fail validation before the API call is made.

What happens if a webhook with the same target already exists?

The Skill lists existing webhooks and checks for a matching target URL. If a duplicate is found, it asks whether you want to update the existing webhook instead of creating a new one.