Quick Start — Tags

A tag is a reusable label (Lead, VIP). Create it once, use it on multiple contacts and in segment rules.

In brief

Create the tag in the dashboard or with POST /v1/tags.
Apply it on the contact record with tagIds or during import.
Filter in segments with a type: tag rule.

Context: Tags in the Audience. Scopes: Tag scopes.

Before you start

Item	Required
Scope `tags:create`	To create
Scope `tags:read`	To list
Scope `contacts:update`	To attach a tag to an existing contact

Auth: Authorization: Bearer sk_live_... or x-api-key. Base URL: https://api.notifique.dev.

1. In the dashboard

Audience → Tags → New
Short name (Lead, Customer, Black Friday)
On the contact record or during import, select the desired tags

2. Create a tag (API)

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

{
  "name": "VIP"
}

Expected response: 200 — save the id to use on contacts and segments.

GET /v1/tags?page=1&limit=50
Authorization: Bearer sk_live_xxxxx

4. Apply a tag to a contact

When creating or editing a contact, send tagIds:

PUT /v1/contacts/{id}
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

{
  "tagIds": ["clxxTagVip", "clxxTagLead"]
}

5. Use in a segment

{
  "version": 1,
  "match": "all",
  "rules": [
    { "type": "tag", "tagId": "clxxTagVip" },
    { "type": "receiveMarketing", "value": true }
  ]
}

Details: Segments — Quick Start.

API E-mail

E-mail

Domínios

E-mails recebidos

Quick Start — Tags

In brief

Before you start

1. In the dashboard

2. Create a tag (API)

4. Apply a tag to a contact

5. Use in a segment

Next steps

​In brief

​Before you start

​1. In the dashboard

​2. Create a tag (API)

​3. List tags

​4. Apply a tag to a contact

​5. Use in a segment

​Next steps

In brief

Before you start

1. In the dashboard

2. Create a tag (API)

3. List tags

4. Apply a tag to a contact

5. Use in a segment

Next steps