How to generate an API key and manage webhooks

Both features are available under Settings > Integrations > Connections in the Demodesk API section.

API keys

An API key lets you authenticate requests to the Demodesk API.

How to generate your API key

1. Go to Settings
2. Open Integrations
3. Select Connections
4. Scroll to the Demodesk API section
5. Under API Key, click Generate API Key

If you already have an API key, you can click Rotate API Key to replace it with a new one.

You can also use the visibility toggle to show or hide the key on screen.

Who can generate an API key?

Any eligible logged-in user can generate and manage their own API key.

When is the API key section available?

The API key section is only available for eligible paid plans. If your company is not eligible, the API section will remain locked.

Webhooks

Webhooks let Demodesk send real-time event updates to an external endpoint.

Who can manage webhooks?

Only company admins can create, edit, or delete webhook endpoints.Managers and regular users cannot manage company webhook endpoints.

How to add a webhook endpoint

1. Go to Settings
2. Open Integrations
3. Select Connections
4. Scroll to the Demodesk API section
5. In the Webhooks area, click Webhook
6. Enter the Webhook URL
7. Select the event you want to subscribe to
8. Optionally add custom headers
9. Click Add endpoint

How to edit a webhook endpoint

1. Go to Settings > Integrations > Connections
2. Open the Demodesk API section
3. In the Webhooks list, find the endpoint you want to update
4. Click Edit webhook
5. Update the URL, event, or headers
6. Click Save changes

How to delete a webhook endpoint

1. Go to Settings > Integrations > Connections
2. Open the Demodesk API section
3. Find the webhook endpoint you want to remove
4. Click the delete icon
5. Confirm removal

Once removed, that endpoint will stop receiving Demodesk events.

What can be configured for a webhook?

Each webhook endpoint can include:

• A Webhook URL
• An event
• Optional custom headers

Custom headers can be useful for authentication, for example:

• Authorization: Bearer abc123

Webhook status

Webhook endpoints can appear with the following statuses:

• Healthy
• Failing
• Disabled

If a webhook keeps failing, it can become disabled after too many failed delivery attempts.

Custom header rules

When configuring webhook headers:

• Each custom header must have both a name and a value
• Header names must be unique
• Some headers are reserved and managed automatically by Demodesk

The following headers cannot be set manually:

• Content-Type
• Content-Length
• Host

Available webhook events

Demodesk currently supports webhook events for key meeting and recording actions, including:

• demo.scheduled
• demo.rescheduled
• demo.event_response_updated
• demo.handovered
• demo.canceled
• demo.started
• demo.call_note_updated
• demo.ended
• recording.uploaded
• recording.transcription_postprocessed

For payload details, refer to the Webhook Payload API Reference.

Still need help?

If you cannot access the Demodesk API section, please check:

• whether your company is on an eligible paid plan
• whether you are a company admin if you want to manage webhooks

If you still need help, contact Demodesk Support via support@demodesk.com