Skip to main content
DELETE
/
api
/
v2
/
lists
/
{ID}
/
subscribers
/
{PHONE_NUMBER}
/
tags
cURL
curl "https://app.tatango.com/api/v2/lists/<ID>/subscribers/<PHONE_NUMBER>/tags" -d '{"tags":["vip","customer"]}' -X DELETE \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -u [email protected]:my_api_key \
  -H "Host: example.org" \
  -H "Cookie: "
{
  "status": "OK",
  "deleted": [
    "local_news",
    "sports_news"
  ],
  "not_found": [
    "celebrity_news",
    "weather_news"
  ],
  "message": "Tag removal completed with partial success."
}
This endpoint allows you to remove multiple tags from a subscriber in a single request. Tags that don’t exist on the subscriber will be reported in the response but won’t cause the request to fail.

​
Request URL

DELETE https://app.tatango.com/api/v2/lists/{ID}/subscribers/{PHONE_NUMBER}/tags

Authorizations

​
Authorization
string
header
required

Tatango authenticates API requests by validating an API key passed via HTTP Basic Authentication. Use your login email as the username and your API key as the password.

Path Parameters

​
ID
integer
required

ID of the list

​
PHONE_NUMBER
string
required

Subscriber's phone number with no special characters

Body

application/json
​
tags
string[]
required

All tags that will be deleted

Example:
["vip", "customer", "newsletter"]

Response

200 - application/json

Tags deletion completed

​
deleted
string[]
required

the tags that were found and deleted from the subscriber

​
not_found
string[]
required

the tags that were not found for the subscriber

​
status
string
required

"OK" if the request was processed successfully or "ERROR" if there was an error processing the request

​
message
string
required

A message explaining if the request was successful (all tags deleted) or partially successful (some tags were not found)