> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/reference/conversations/conversation-created-webhook/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Webhook: Conversation created

POST 

A webhook sent when a conversation is created

Reference: https://docs.ada.cx/reference/conversations/conversation-created-webhook

## Request

### Payload

- `type` (enum, optional) — The webhook event type
  - Allowed values: `v1.conversation.created`
- `timestamp` (string, optional) — The timestamp for when the event was generated (uses millisecond precision to help with event ordering)
- `data` (ConversationCreatedWebhookPayloadData, optional) — The webhook event data

## Types

### ConversationCreatedWebhookPayloadData

The webhook event data

- `conversation_id` (string, optional) — The ID of the conversation
- `channel_id` (string, optional) — The ID of the channel
- `created_at` (string, optional) — The date and time the conversation was created
- `end_user_id` (string, optional) — The ID of the end user associated with the conversation
- `metadata` (map from string to ConversationCreatedWebhookPayloadDataMetadata, optional) — A dictionary of key, value pairs assigned to the conversation - `metadata` keys may only be of type: `string` - `metadata` values may only be one of type: `string`, `boolean`, `integer`, or `number` (float)
- `ai_agent_domain` (string, optional) — The API domain of the AI Agent environment this webhook event is emitted from

### ConversationCreatedWebhookPayloadDataMetadata