Setting Up Webhooks

Webhooks send HTTP POST requests to your server when specific events occur in Diaform. Use them to sync completed interview data with your own systems or trigger custom workflows.

Supported Events#

Diaform currently supports one webhook event:

conversation.completed: Fires when an interview finishes and the AI-generated summary is ready

Setting Up a Webhook#

Navigate to Organization Settings and select the Webhooks tab.

Enter your endpoint URL. The URL must use HTTPS.

Click Add to create the webhook.

Copy the generated webhook secret and store it in your server environment. The secret is used to verify webhook signatures.

Treat your webhook secret like a password. You can reveal and copy it from the webhook row later, but it should only be stored in trusted server-side environments.

Managing Webhooks#

From the Webhooks page, you can:

Reveal and copy the webhook secret for signature verification
Toggle active/inactive to pause delivery without deleting the endpoint
Delete webhooks you no longer need

Multiple Webhooks#

You can add multiple webhook endpoints to the same organization. When an event occurs, all active matching webhooks receive the payload in parallel.

Delivery Details#

Webhooks are sent in parallel to all active endpoints
Each request has a 5-second timeout
Failed deliveries are logged but do not retry
Your endpoint should respond with a 2xx status code

For payload details, see Webhook Payload Reference. To verify webhook authenticity, see Verifying Webhook Signatures.