List Priority Inbox messages

Comments and messages from Activity > Priority Inbox, with sentiment.

GET https://cotlet.dev/api/v1/sendible/workspaces/{workspace_id}/inbox-messages

read

Returns inbox messages for profiles with alerts on: Facebook Page comments, replies and direct messages, Facebook Ads comments, Instagram Professional comments, LinkedIn Company Page replies and YouTube comments. Each has type public_comment or private_message and a sentiment of positive, neutral or negative, which Sendible scores from good and bad words. Messages arrive 1 to 2 hours late and only for recent posts. X, TikTok, Google Business and Instagram direct messages never appear.

Parameters

Parameters: list_inbox_messages
NameTypeDescription
workspace_id string required string Workspace from list_workspaces.
profile_id string string Only messages for this profile.
from date date Only messages on or after this day, YYYY-MM-DD.
to date date Only messages on or before this day.
search string string Words to find in the message body.
archived_only boolean boolean Show the Archived Only view. Default: false.

Request

cURL
curl https://cotlet.dev/api/v1/sendible/workspaces/workspace_8c41d2/inbox-messages \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("sendible", "list_inbox_messages", {"workspace_id":"workspace_8c41d2"})
Node.js
const result = await cotlet.call('sendible', 'list_inbox_messages', {"workspace_id":"workspace_8c41d2"});
CLI
cotlet call sendible list_inbox_messages --data '{"workspace_id":"workspace_8c41d2"}'

Example response

JSON

{
  "messages": [
    {
      "message_id": "msg_91f2",
      "profile": "Harbor Dental (Facebook Page)",
      "type": "public_comment",
      "author": "Dana Cole",
      "text": "Do you open on Saturdays?",
      "sentiment": "neutral",
      "received_at": "2026-10-20T06:42:00+01:00",
      "hours_waiting": 3,
      "archived": false
    },
    {
      "message_id": "msg_91f9",
      "profile": "Harbor Dental (Instagram)",
      "type": "public_comment",
      "author": "Ben Ortiz",
      "text": "Love the new waiting room",
      "sentiment": "positive",
      "received_at": "2026-10-20T02:10:00+01:00",
      "hours_waiting": 7,
      "archived": false
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.