Reply to a conversation

Sends a real message through the connected provider, or an email from the workspace sending address on email conversations. Fails with 409 when no provider is connected, when the person replied STOP or unsubscribed, or when a WhatsApp reply window has closed and no template is given.

POSThttps://app.softsolz.uk/api/v1/services/outreach/inbox/conversations/{id}/reply

Recent Requests

Kept only in this browser

TimeStatusTook

Send a request with Try it to see it here.

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

bodystring

Reply text. Required unless a template is given.

subjectstring

Subject line for an email reply. Defaults to Re: and the last subject.

templateobject

An approved WhatsApp template. Needed when the person last wrote more than 24 hours ago.

Response

Response Body

sentbooleanAlways true when the reply went out.

providerstringProvider that carried the reply.

conversationobjectThe conversation.

Request

curl --request POST \
  --url https://app.softsolz.uk/api/v1/services/outreach/inbox/conversations/{id}/reply \
  --header 'Authorization: Bearer sk_live_your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "body": "Yes, the offer runs until Sunday."
}'

Credentials

Authorization

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 201

{
  "data": {
    "sent": true,
    "provider": "twilio",
    "conversation": {
      "id": "311",
      "tenant_id": "4c1a7e52-9b3d-4f86-a2e1-7d5c0b9f3e61",
      "customer_id": null,
      "phone": "+447700900123",
      "email": null,
      "contact_id": null,
      "channel": "sms",
      "status": "open",
      "assigned_to": null,
      "assignee_name": null,
      "display_name": "Jane Doe",
      "last_inbound_at": "2026-10-01T08:30:00.000Z",
      "last_outbound_at": null,
      "last_message_at": null,
      "last_message_preview": "Is the offer still on?",
      "unread_count": 1,
      "auto_reply_enabled": true,
      "labels": [
        "vip"
      ],
      "ai_summary": null,
      "ai_intent": null,
      "ai_summarised_at": null,
      "reply_window_expires_at": null,
      "reply_window_open": true,
      "created_at": "2026-09-01T09:00:00.000Z",
      "updated_at": "2026-09-01T09:00:00.000Z"
    }
  }
}