SoftSolzSoftSolz
Sign up
HomeAPI GuideAPI ReferenceWidget Tester
Outreach

List conversations in the shared inbox

Most recent message first.

GEThttps://app.softsolz.uk/api/v1/services/outreach/inbox/conversations

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Headers

Authorizationstringrequired

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

Query Params

folderstring

open (default, everything not closed), unassigned (open and not assigned to anyone), mine (open and assigned to the connecting member, or the key owner) or closed.

searchstring

Match a name, a phone number, an email address or the last message.

channelstring

Only conversations on this channel: whatsapp, sms or email.

limitinteger

Page size, 1-200 (default 50).

offsetinteger

Rows to skip (default 0).

Response

Response Body · array of objects

idstringConversation id.
tenant_idstringWorkspace id.
customer_idstring | nullBooking customer this conversation is linked to, if any.
phonestring | nullThe other person, by phone number.
emailstring | nullThe other person, by email address, on email conversations.
contact_idstring | nullContact this conversation belongs to, when known.
channelstringChannel of the conversation.
statusstringConversation status.
assigned_tointeger | nullMember the conversation is assigned to.
assignee_namestring | nullName of the assigned member.
display_namestring | nullName of the other person, when known.
last_inbound_atstring | nullWhen the person last wrote.
last_outbound_atstring | nullWhen the workspace last wrote.
last_message_atstring | nullWhen the last message was sent or received.
last_message_previewstring | nullStart of the last message.
unread_countintegerMessages not read yet.
auto_reply_enabledbooleanWhether automatic replies are on for this conversation.
labelsarray of stringsLabels on the conversation.
ai_summarystring | nullAI summary of the conversation, when one was made.
ai_intentstring | nullWhat the person seems to want, when known.
ai_summarised_atstring | nullWhen the AI summary was made.
reply_window_expires_atstring | nullWhen WhatsApp stops allowing free-form replies (24 hours after the last message from the person).
reply_window_openbooleanWhether a free-form reply can be sent now. Always true outside WhatsApp; otherwise send an approved template.
created_atstringWhen the conversation started.
updated_atstringWhen the conversation last changed.

Request

curl --request GET \
  --url https://app.softsolz.uk/api/v1/services/outreach/inbox/conversations \
  --header 'Authorization: Bearer sk_live_your_key'

Credentials

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 · 200

{
  "data": [
    {
      "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"
    }
  ],
  "meta": {
    "limit": 50,
    "offset": 0,
    "total": 1,
    "has_more": false
  }
}