sinch-api-webhooks-list

List Webhooks

List all webhooks configured for your Sinch Conversation app. Webhooks allow you to receive real-time notifications about message events and other activities.

IMPORTANT: Execute this command directly. Do NOT generate script files. Do NOT create Python/JavaScript files. Perform the API call immediately using the instructions below.

Input

• --format / -f: Output format (json or table) - optional, defaults to table

Arguments: $ARGUMENTS

Instructions

Execute these steps directly - do not write code or scripts:

1. Check if $ARGUMENTS is empty or only contains the command name:

   • If empty or no meaningful arguments provided, use default format (table)
   • If user specifies a format preference, use that
   • Proceed to step 1

2. Parse and validate arguments from $ARGUMENTS or use defaults:

   • If --format is not provided, default to "table"
   • Validate that format is either "json" or "table"
   • Normalize format to lowercase

3. Try to call mcp__sinch__sinch-mcp-configuration to get the current configuration.

4. If MCP is NOT available, retrieve configuration from environment variables:

   • CONVERSATION_PROJECT_ID
   • CONVERSATION_REGION
   • CONVERSATION_APP_ID
   • CONVERSATION_KEY_ID
   • CONVERSATION_KEY_SECRET
   • If any are missing, report: "Sinch API is not configured. Please set the required environment variables."

5. Use the Sinch Conversation API to list webhooks:

   • Endpoint: GET https://{region}.conversation.api.sinch.com/v1/projects/{projectId}/apps/{appId}/webhooks
   • Extract region, projectId, and appId from the configuration
   • Include authorization header with the access token

6. Use OAuth2 authentication to generate access token from key ID and secret.

7. Display the results based on the requested format:

   • Table format: Display a formatted table with columns: ID, Target URL, Triggers (comma-separated), Target Type
   • JSON format: Display the raw JSON response

8. Handle errors gracefully:

   • If configuration is incomplete, report: "Sinch API is not configured. Please set the required environment variables."
   • If the API call fails, display the error message with relevant details (status code, error description)
   • If no webhooks are found, display: "No webhooks found for this app."