API Documentation
POST /api/webhooks/conversations
Create a conversation for your organization.
Required fields
customer_email(string) - Customer’s email addressmessage(string) - Message body (plain text)
Optional fields
customer_name(string) - Customer’s display namesubject(string) - Conversation subject linemessage_html(string) - HTML version of the messagepriority(string) -low,medium,high, orurgentassignee_email(string) - Auto-assign to a team memberexternal_id(string) - Idempotency key to prevent duplicates
Request Example
curl -X POST https://api.letterbook.ai/api/webhooks/conversations \
-H "Authorization: Bearer hld_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"customer_email": "[email protected]",
"customer_name": "John Doe",
"subject": "Help with order",
"message": "I need help with my recent order.",
"priority": "high",
"external_id": "ticket-123"
}'Response
id(string) - Unique conversation ID (UUID)display_id(integer) - Human-readable ticket numberstatus(string) - Conversation statusurl(string) - Direct link to the conversation in the dashboard