skills.rest
sinch
sinchOFFICIAL
Explore all skills by this author →
WebsiteGitHub

sinch-api-contacts-list

List and search contacts in the Sinch Conversation API with channel filtering and pagination.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Retrieving and browsing end-user contacts from a Sinch Conversation API project requires manual API calls with OAuth2 authentication, pagination handling, and response formatting, which is tedious to do by hand. ## Core Features & Use Cases - Contact Listing: Retrieve all contacts in a Sinch Conversation API project with their channel identities (phone, WhatsApp, RCS). - Channel Filtering & Pagination: Filter results by channel (SMS, WHATSAPP, RCS), control page size, and navigate pages with tokens. - Flexible Output: Display results as a readable table or raw JSON for further processing. - Use Case: A support engineer needs to verify which end-users are registered on the WhatsApp channel before debugging message delivery, so they list contacts filtered by WHATSAPP in JSON format. ## Quick Start Ask the assistant to list your Sinch Conversation API contacts, optionally filtered by channel such as WHATSAPP with a page size of 50.

Frequently Asked Questions about sinch-api-contacts-list

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

FAQPage Schema
How do I list contacts in the Sinch Conversation API?▼

Send a GET request to /v1/projects/{projectId}/contacts on the regional Conversation API endpoint with an OAuth2 Bearer token. This skill performs that call directly and formats results as a table or JSON.

How to filter Sinch contacts by channel like WhatsApp?▼

Pass the channel query parameter with a value such as WHATSAPP, SMS, or RCS when calling the contacts endpoint. Use the --channel or -c flag, for example --channel=WHATSAPP, to return only contacts on that channel.

What credentials does the Sinch Conversation API require?▼

It requires 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 does pagination work when listing Sinch contacts?▼

The API returns a page_token when more results exist. Set --page-size to control results per page (default 20) and pass --page-token with the returned token to fetch the next page.

Why do I get a 401 error when listing Sinch contacts?▼

A 401 response indicates invalid or expired OAuth2 credentials. Verify that your Key ID and Key Secret from the Sinch Customer Dashboard are correct and match the project and region you are querying.

Related Skills

Explore More Software Engineering Skills→
sinchsinch
9

sinch-authentication

Configure Sinch API credentials and authentication across services.

Official
Intermediate
sinchsinch
9

sinch-conversation-api

Send and receive omnichannel messages via the Sinch Conversation API.

Official
Advanced
sales-skillssales-skills

sales-customerio

Create and configure Customer.io messaging automations for onboarding and lifecycle campaigns.

Official
Advanced
discoursediscourse
47.8k

discourse-writing-html-css

Write and repair HTML, CSS, and SCSS for Discourse core, plugins, themes, and theme components.

Official
Advanced