Open API v1

Sync contacts from your CRM

Create or update TaggoAI contacts from an external system.

Required scope: contacts:write (and contacts:read to look up first).

Create

bash

curl -X POST https://api.taggoai.com/open/v1/contacts \
  -H "Authorization: Bearer tg_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: crm-contact-123" \
  -d '{
    "name": "Ada Nguyen",
    "email": "[email protected]",
    "phone": "+84901234567",
    "source": "crm",
    "tags": ["vip"],
    "external_ids": { "crm": "123" }
  }'

Store id from the response. Use external_ids to keep your CRM primary key.

Look up, then update

bash

curl "https://api.taggoai.com/open/v1/[email protected]" \
  -H "Authorization: Bearer tg_live_YOUR_KEY"

bash

curl -X PATCH https://api.taggoai.com/open/v1/contacts/CONTACT_ID \
  -H "Authorization: Bearer tg_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "lifecycle_stage": "customer", "tags": ["vip", "retail"] }'

PATCH only changes the fields you send.

Search

search matches name, email, or phone. Combine with tag, segment, lifecycle_stage, created_after, and created_before.