Remove Email Contact Tags API
Remove tags from an email contact by email address.
Remove tags from one subscriber. Missing tags are ignored, so the operation is idempotent.
Request
DELETE /api/v1/email/contacts/:email/tagsPass tags in the query string:
curl -X DELETE \
"https://growth.example.com/api/v1/email/contacts/lead%40example.com/tags?tags=vip,newsletter" \
-H "x-api-key: org_api_key"Or send a JSON body:
{ "tags": ["vip", "newsletter"] }Response
{
"contact": {
"email": "[email protected]",
"tags": []
},
"tags": [],
"skippedTags": []
}Error responses:
| Status | Meaning |
|---|---|
400 | Missing tags or invalid email. |
401 | Missing or invalid API key. |
404 | Contact not found. |
Notes
- Removing tags does not unsubscribe the contact.
- Use
DELETE /api/v1/email/contacts/:emailto unsubscribe a contact from email sending.