Create a conversation

Markdown

View as Markdown

POST /v1/conversations

Creates a new conversation and returns its ID.

Request

curl -X POST https://api.acme.dev/v1/conversations \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "subject": "Billing question", "email": "a@b.com" }'

Response

{
  "id": "conv_123",
  "status": "open",
  "subject": "Billing question"
}

Fields

  • subject (string, required)
  • email (string, required)

Related Articles