List Smart Inbox messages
List messages in a Smart Inbox view, with their reply, completed and tag state.
GET https://cotlet.dev/api/v1/sprout-social/inbox-messages
read
Returns comments and private messages from the Smart Inbox in the order Sprout shows them, with the author, text, network, tags and whether the message was replied to or completed. Pick a view with view; the five built-in views are fixed. Results are paged: pass the returned cursor to continue.
Parameters
| Name | Type | Description |
|---|---|---|
| view string | string | Inbox view: all_messages (default), private_messages, completed_messages, saved_messages or reply_approvals. |
| profile_ids string[] | string[] | Profile IDs from list_profiles. Leave empty for every profile your login can see. |
| since string | string | Only messages received after this ISO date-time. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/sprout-social/inbox-messages \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("sprout-social", "list_inbox_messages")const result = await cotlet.call('sprout-social', 'list_inbox_messages');cotlet call sprout-social list_inbox_messagesExample response
{
"messages": [
{
"message_id": "msg_88a1f4",
"profile_id": "p_ig_01",
"network": "instagram",
"type": "comment",
"author": "Lena Ortiz",
"text": "Is the blue one back in stock?",
"received_at": "2026-10-17T08:12:00+02:00",
"tags": [],
"replied": false,
"completed": false
},
{
"message_id": "msg_88a1f9",
"profile_id": "p_fb_03",
"network": "facebook",
"type": "private_message",
"author": "Sam Okafor",
"text": "I was charged twice in October.",
"received_at": "2026-10-17T08:40:00+02:00",
"tags": [],
"replied": false,
"completed": false
}
],
"next_cursor": null
}