Create Conversation

API Documentation

POST /api/webhooks/conversations

Create a conversation for your organization.

Required fields

• customer_email (string) - Customer’s email address
• message (string) - Message body (plain text)

Optional fields

• customer_name (string) - Customer’s display name
• subject (string) - Conversation subject line
• message_html (string) - HTML version of the message
• priority (string) - low, medium, high, or urgent
• assignee_email (string) - Auto-assign to a team member
• external_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 number
• status (string) - Conversation status
• url (string) - Direct link to the conversation in the dashboard