Quick Start - Notifique

Suggested order: tags and fields → contacts → topics → segments → campaigns. A contact needs phone or email (or both).

In short

Contact = the person. Tag = label. Topic = consent per theme. Segment = saved filter. Campaign = batch send.
Use the API reference on the Contacts tab for exact routes.

Scope: tags:create.

POST /v1/tags
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

{
  "name": "Lead"
}

Expected response: 200, save the id for tagIds when creating contacts.

Scope: contacts:create.

POST /v1/contacts
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

{
  "phone": "5511999999999",
  "name": "John Silva",
  "email": "john@example.com",
  "telegramPeer": "123456789",
  "tagIds": ["clxxTag1"]
}

Expected response: 200 with contact id.

Scope: contacts:read.

GET /v1/contacts?page=1&limit=20&search=john
Authorization: Bearer sk_live_xxxxx

Optional filters: search, tagId.

Goal	Typical scope	Guide
Marketing topics	`topics:*`	Topics
Rule-based audience	`segments:*`	Segments
Batch send	`campaigns:create`, `campaigns:run` + channel send scopes	Campaigns