Skip to main content
POST
/
api
/
v2
/
lists
/
{ID}
/
bulk_taggings
cURL
curl "https://app.tatango.com/api/v2/lists/ID/bulk_taggings" -d '{"bulk_tagging":{"phone_numbers":["2065551111","2065551112"],"tags":["vip","customer"],"replace_tags":false}}' -X POST \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -u [email protected]:my_api_key \
  -H "Host: example.org" \
  -H "Cookie: "
{
  "number_count": 3,
  "tag_count": 3,
  "subscribers_to_update": 2,
  "replace_tags": false,
  "not_subscribed": [
    "2065551113"
  ],
  "invalid_numbers": []
}
Other uses You can also use this endpoint to mass remove tags from subscribers. For example if replace_tags is true and your tags list is empty it will remove all tags from your numbers list

​
Request URL

POST https://app.tatango.com/api/v2/lists/{ID}/bulk_taggings

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

Body

application/json
​
bulk_tagging
object
required

Response

200 - application/json

Bulk tagging operation completed

​
number_count
integer
required

The number of phone numbers in your passed phone_numbers list

Example:

3

​
tag_count
integer
required

The number of tags in your passed tags list

Example:

3

​
subscribers_to_update
integer
required

The number of subscribed members to your list that will be updated with the new tags

Example:

2

​
replace_tags
boolean
required

If true all the tags for subscribers will be replaced with the new tags. If false it will add the new tags to the old tags

Example:

false

​
not_subscribed
string[]

A list of phone numbers that were passed that are not subscribed to the defined list. If all numbers are subscribed this will not be displayed

Example:
["2065551113"]
​
invalid_numbers
string[]

A list of phone numbers that were passed in that are not valid phone numbers. An invalid number will also consist of landline phones. If all numbers are valid this will not be displayed

Example:
[]