Add Email Contact Tags API

Add tags to an email contact by email address.

Add tags to one subscriber. Tags are normalized, deduplicated, and merged with the contact's existing tags.

Request

POST /api/v1/email/contacts/:email/tags

Body:

Field	Type	Required	Description
`tags`	`string[]`	Yes	Tags to add.

You can also pass ?tags=tag-a,tag-b for simple scripts.

curl -X POST https://growth.example.com/api/v1/email/contacts/lead%40example.com/tags \
  -H "x-api-key: org_api_key" \
  -H "Content-Type: application/json" \
  -d '{"tags":["vip","newsletter"]}'

Response

{
  "contact": {
    "email": "[email protected]",
    "tags": ["newsletter", "vip"]
  },
  "tags": ["newsletter", "vip"],
  "skippedTags": []
}

Error responses:

Status	Meaning
`400`	Missing tags or invalid email.
`401`	Missing or invalid API key.
`404`	Contact not found — this endpoint does not create contacts.

Notes

This endpoint never creates a contact. A signup hook firing before Growth has seen the address gets a 404 and the contact is lost. Use Identify instead, which upserts and is additive in the same way.
Adding a tag can trigger active tag-based workflows for subscribed contacts.
Tags are lowercased and deduplicated. A contact holds at most 50 tags; additions beyond the cap are reported in skippedTags instead of failing the call.

Unsubscribe Email Contact API Remove Email Contact Tags API