Messaging

The messaging methods give you one inbox across all connected accounts: list conversations, read a thread, and send or reply to messages.

List chats

GET /v1/chats?account_id={account_id}&limit={limit}&cursor={cursor}

Query param	Type	Required	Description
account_id	string	no	Limit to one account. Omit for all accounts.
limit	integer	no	Page size, default 50.
cursor	string	no	Pagination cursor — see Pagination.

curl "https://api.correctinbox.com/v1/chats?account_id=acc_8f21c0" \
  -H "X-API-KEY: $CORRECTINBOX_API_KEY"

const { chats, cursor } = await (
  await fetch("https://api.correctinbox.com/v1/chats?account_id=acc_8f21c0", {
    headers: { "X-API-KEY": process.env.CORRECTINBOX_API_KEY },
  })
).json();

data = requests.get(
    "https://api.correctinbox.com/v1/chats",
    headers={"X-API-KEY": os.environ["CORRECTINBOX_API_KEY"]},
    params={"account_id": "acc_8f21c0"},
).json()

Response

{
  "chats": [
    {
      "id": "cht_19ab",
      "account_id": "acc_8f21c0",
      "attendee": { "id": "ACoAAB1x...", "name": "Priya Menon" },
      "last_message": "Thanks for reaching out!",
      "last_message_at": "2026-02-01T17:55:00Z",
      "unread": true
    }
  ],
  "cursor": null
}

A chat is unread only when the latest message is from the other person and you haven't read it yet. Reading a thread marks it read.

Get messages in a chat

GET /v1/chats/{chat_id}/messages

curl https://api.correctinbox.com/v1/chats/cht_19ab/messages \
  -H "X-API-KEY: $CORRECTINBOX_API_KEY"

Response

{
  "messages": [
    { "id": "msg_01", "from_me": false, "text": "Thanks for reaching out!", "sent_at": "2026-02-01T17:55:00Z" }
  ]
}

Send a message

Reply in an existing chat, or start one with a connection by passing an attendee_id.

POST /v1/chats/{chat_id}/messages

Field	Type	Required	Description
text	string	yes	The message body.

curl -X POST https://api.correctinbox.com/v1/chats/cht_19ab/messages \
  -H "X-API-KEY: $CORRECTINBOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Happy to share more — are you free Thursday?" }'

await fetch("https://api.correctinbox.com/v1/chats/cht_19ab/messages", {
  method: "POST",
  headers: {
    "X-API-KEY": process.env.CORRECTINBOX_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ text: "Happy to share more — are you free Thursday?" }),
});

requests.post(
    "https://api.correctinbox.com/v1/chats/cht_19ab/messages",
    headers={"X-API-KEY": os.environ["CORRECTINBOX_API_KEY"]},
    json={"text": "Happy to share more — are you free Thursday?"},
)

Response

{ "object": "message", "id": "msg_02", "chat_id": "cht_19ab", "from_me": true }

Listen for the message.received webhook to handle replies in real time.