Send a message

Send a direct message to a customer via email, SMS, or WhatsApp

Related endpoints

• GET /comms/threads — List conversation threads
• GET /comms/threads/{threadId}/messages — List messages in a thread

Common errors

• 400 invalid_request — malformed payload or failed validation.

Idempotency

Pass an Idempotency-Key header (UUID v4 recommended) to make retries safe. Keys are valid for 24 hours; see the idempotency guide.

curl -X POST "https://api.revkeen.com/v2/comms/send" \
  -H "x-api-key: $REVKEEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "body": "string"
  }'

{
  "success": true,
  "conversation_id": "cc71b11a-25cd-4c2d-9950-df2cc38e3407",
  "message_id": "d7d9d9fd-478f-40e6-b651-49b7f19878a2",
  "notification_id": "f96afe21-aef9-465c-a9f6-813055655b04",
  "customer_id": "160c0c4b-9966-4dc1-a916-8407eb10d74e"
}

{
  "error": "string"
}