Webhooks in SigmaMind let you receive real-time notifications about events happening in your AI agents.
Whenever an event is triggered (e.g., a conversation starts or ends), SigmaMind will send an HTTP POST request with a JSON payload to your configured webhook URL. This allows you to connect SigmaMind with your own applications, CRMs, or monitoring systems.

​
How Webhooks Work

  • Each AI Agent can have its own webhook.
  • A single webhook URL can be reused across multiple agents.
  • When the selected event occurs, SigmaMind sends a signed JSON payload to your webhook endpoint.
  • Your system can then process this payload to perform actions like updating CRM records, triggering workflows, or logging analytics.
Think of webhooks as push notifications for your backend — you get updates instantly when something important happens in SigmaMind.

​
Supported Webhook Events

The following events are currently supported:
  • conversation_started – Triggered when a new customer conversation begins.
  • conversation_ended – Triggered when a conversation is closed or completed.
Additional events such as node_executed and post_call_analysis_completed will be supported in future releases.

​
Creating Webhooks

You can create webhooks in two ways:

​
1. Using the Dashboard

  1. Navigate to Settings → Webhooks.
  2. Click Add New Webhook.
  3. Enter the Webhook Name and Destination URL.
  4. Select the Events you want this webhook to listen to.
  5. Save the configuration.
Alternatively, you can configure webhooks from Agent Settings:
  1. Open the AI Agent you want to connect.
  2. Go to Agent Settings → Webhooks.
  3. Provide the Webhook URL, Secret Key, and choose the Events.
  4. Save the settings.

​
2. Using the API

If you prefer programmatic control, you can use the Webhook API to register webhooks.
  • The name field is a human-readable identifier for your webhook.
  • The url is the endpoint in your system that will receive webhook events.
  • The agentId must correspond to an existing Agent in your SigmaMind account.
  • The secret is used to sign payloads for verification.
  • The events parameter lists which Agent events will trigger the webhook.
curl --location 'https://api.sigmamind.ai/v1/webhooks' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: key_C6HL3Goru7Q.TlI5kZOKPmDM03Gt39nRBEnxrL*******************' \
--data '{
    "name": "Test Webhook 1",
    "url": "https://your-server.com/webhooks/ai-agent",
    "agentId": "D5D0p7TUs66TTAEAx",
    "secret": "your-signing-secret",
    "events": [
        "conversation_started",
        "conversation_ended"
    ]
}'

​
Security and Verification

  • All webhook payloads are signed using the secret you provide during setup.
  • Your server should validate the signature to confirm the request is authentic and originated from SigmaMind.
Always verify signatures before processing webhook data to prevent spoofing attacks.

​
Summary

  • Webhooks notify your system in real time about Agent events.
  • You can create webhooks from the Dashboard or via the API.
  • A single webhook URL can be used across multiple AI Agents.
  • Supported events include conversation_started and conversation_ended.
  • Payloads are signed with a secret key for secure delivery.
Webhooks are the easiest way to integrate SigmaMind into your existing systems and automate workflows.