API/Remove Email Contact Tags API

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/tags

Pass 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:

StatusMeaning
400Missing tags or invalid email.
401Missing or invalid API key.
404Contact not found.

Notes

  • Removing tags does not unsubscribe the contact.
  • Use DELETE /api/v1/email/contacts/:email to unsubscribe a contact from email sending.