RCS

rcs.contacts

Manage the RCS audience stored on your workspace. Contacts carry RCS capability hints (cached from prior sends) so you can segment before launching expensive broadcasts.

#Endpoints

GET/v1/rcs/contactsList RCS contacts. Supports search, rcsCapable, tag filters.
GET/v1/rcs/contacts/:idFetch a single RCS contact by id.
POST/v1/rcs/contactsCreate a contact. If the phone already exists we return the existing record.
PATCH/v1/rcs/contacts/:idUpdate name, tags, custom fields, or opt-in status. Opt-out sets subscribed=false.

GET/v1/rcs/contacts

List RCS contacts. Supports search, rcsCapable, tag filters.

SDK

TypeScript

const { contacts } = await zaptick.rcs.contacts.list({
  rcsCapable: true,
  tag: 'vip',
  limit: 50,
});

GET/v1/rcs/contacts/:id

Fetch a single RCS contact by id.

SDK

TypeScript

const { contact } = await zaptick.rcs.contacts.get('64f…');

POST/v1/rcs/contacts

Create a contact. If the phone already exists we return the existing record.

SDK

TypeScript

const { contact } = await zaptick.rcs.contacts.create({
  phone: '+919876543210',
  name: 'Priya',
  tags: ['vip'],
  customFields: { plan: 'gold' },
});

Request body

JSON

{
  "phone": "+919876543210",
  "name": "Priya",
  "tags": ["vip"],
  "customFields": { "plan": "gold" }
}

PATCH/v1/rcs/contacts/:id

Update name, tags, custom fields, or opt-in status. Opt-out sets subscribed=false.

SDK

TypeScript

await zaptick.rcs.contacts.update('64f…', {
  tags: ['vip', 'fy26-campaigns'],
  customFields: { plan: 'platinum' },
});