Skip to main content
GET
/
v1
/
webhooks
/
{webhookId}
Get Webhook
curl --request GET \
  --url https://api.sigmamind.ai/v1/webhooks/{webhookId} \
  --header 'X-API-Key: <api-key>'
{
  "workspaceId": "org_BUbkx3PsbzQm5V10",
  "webhookId": "wh_BUbkx3PsbzQm5V10",
  "name": "Call Events - Production",
  "agentId": "D5D0p7TUs66TTAEAx",
  "active": true,
  "secret": "mK9vXq2pL8nR5tY1wA3sD6fH0jC4bE7u",
  "events": "conversation_started",
  "url": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.sigmamind.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Authenticate every request by passing your API key in the X-API-Key header. To get your key, go to Dashboard → API Keys and create or copy your Production API key.

Path Parameters

​
webhookId
string
required

Unique identifier of the webhook to retrieve. Obtained from the webhookId field in the Create Webhook or List Webhooks response.

Response

OK

Full details of a registered webhook. Includes delivery target, the agent it is scoped to, active status, subscribed events, and the secret used to verify payload authenticity.

​
workspaceId
string

Unique identifier of the workspace this webhook belongs to. Use this value to scope queries or filter webhooks by workspace.

Example:

"org_BUbkx3PsbzQm5V10"

​
webhookId
string

Unique identifier for this webhook. Use this value as webhookId when updating, deleting, or retrieving this webhook via the API.

Example:

"wh_BUbkx3PsbzQm5V10"

​
name
string

Display name of this webhook as set at creation time. Used to identify it in listings and dashboards.

Example:

"Call Events - Production"

​
agentId
string

Unique identifier of the agent this webhook is scoped to. Only events originating from this agent are delivered to this webhook's URL.

Example:

"D5D0p7TUs66TTAEAx"

​
active
boolean

Whether this webhook is currently active and will receive event deliveries. When false, the webhook is registered but no events are sent to the URL. Toggle this to pause or resume delivery without deleting the webhook.

Example:

true

​
secret
string

HMAC secret key used to sign outgoing webhook payloads. The system includes a signature header on each delivery computed using this secret. Verify the signature on your server to confirm payloads are genuinely from SigmaMind. Store this value securely — it is only returned at creation time.

Example:

"mK9vXq2pL8nR5tY1wA3sD6fH0jC4bE7u"

​
events
enum<string>[]

Event types this webhook is subscribed to. Only events in this list trigger a delivery to the webhook URL. 'conversation_started' fires when an agent session begins. 'conversation_ended' fires when a session closes. 'conversation_analysed' fires when post-call analysis is complete.

Event types this webhook is subscribed to. Only events in this list trigger a delivery to the webhook URL. 'conversation_started' fires when an agent session begins. 'conversation_ended' fires when a session closes. 'conversation_analysed' fires when post-call analysis is complete.

Available options:
conversation_started,
conversation_ended,
conversation_analysed
​
url
string