sinch-api-messages-list

List and retrieve messages from the Sinch Conversation API with channel and pagination filters.

6|2|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/sinch/sinch-plugins --skill sinch-api-messages-list-sinch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sinch-api-messages-list
Source: https://github.com/sinch/sinch-plugins/tree/main/plugins/sinch-antigravity-plugin/skills/sinch-api-messages-list
Command: npx skills add https://github.com/sinch/sinch-plugins --skill sinch-api-messages-list-sinch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Retrieving message history from the Sinch Conversation API requires constructing authenticated REST calls with the correct query parameters, which is tedious to do manually from the command line. ## Core Features & Use Cases - Filtered Message Listing: List messages filtered by channel (SMS, RCS, WHATSAPP), contact ID, or conversation ID. - Pagination Support: Control page size and follow page tokens to page through large message histories. - Flexible Output: Display results as a readable table or raw JSON for further processing. - Use Case: A support engineer needs to audit the last 20 SMS messages sent to a specific contact; they run the list command with the contact ID and channel filter to inspect delivery state and timestamps. ## Quick Start Ask the assistant to list the last 10 SMS messages for a given contact ID using the Sinch Conversation API.

Frequently Asked Questions about sinch-api-messages-list

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list messages from the Sinch Conversation API?

Run the list command with optional filters such as --channel, --contact-id, or --conversation-id. The skill calls the Conversation API messages endpoint with an OAuth2 Bearer token and returns results as a table or JSON.

How do I filter Sinch messages by channel like SMS or WhatsApp?

Pass the --channel flag with a value such as SMS, RCS, or WHATSAPP. You can combine it with --contact-id or --conversation-id and set --page-size to control how many results are returned.

What credentials are required to list Sinch Conversation API messages?

You need CONVERSATION_PROJECT_ID, CONVERSATION_KEY_ID, CONVERSATION_KEY_SECRET, CONVERSATION_REGION, and CONVERSATION_APP_ID environment variables. If these are missing, the skill reports that the Sinch API is not configured.

How do I paginate through a large Sinch message history?

Set --page-size to control results per page and use the page token returned in the response as the --page-token value for the next request. Repeat until no further token is returned.

Why does listing Sinch messages return a 403 or 404 error?

A 403 typically means invalid or insufficient API credentials, while a 404 indicates a wrong project, app, contact, or conversation ID. Verify your environment variables and identifiers, and check the messages_source parameter for your app configuration.