Updating a Subscriber

cURL

curl "https://app.tatango.com/api/v2/lists/<ID>/subscribers/<SUBSCRIBER_ID>" -d '{"subscriber":{"phone_number":"2141234567","first_name":"John","last_name":"Doe"}}' -X PUT \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -u [email protected]:my_api_key \
  -H "Host: example.org" \
  -H "Cookie: "

{
  "status": "Subscriber updated",
  "subscriber": {
    "phone_number": "2141234567",
    "cleaned_at": null,
    "subscribed_at": "2025-06-18T15:36:07Z",
    "opted_out_at": null,
    "opt_in_method": "api",
    "keyword_name": null,
    "carrier": 383,
    "carrier_name": "Verizon Wireless",
    "global_carrier_id": "12345",
    "global_carrier_name": "Verizon"
  }
}

PUT

api

lists

{ID}

subscribers

{SUBSCRIBER_ID}

cURL

curl "https://app.tatango.com/api/v2/lists/<ID>/subscribers/<SUBSCRIBER_ID>" -d '{"subscriber":{"phone_number":"2141234567","first_name":"John","last_name":"Doe"}}' -X PUT \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -u [email protected]:my_api_key \
  -H "Host: example.org" \
  -H "Cookie: "

{
  "status": "Subscriber updated",
  "subscriber": {
    "phone_number": "2141234567",
    "cleaned_at": null,
    "subscribed_at": "2025-06-18T15:36:07Z",
    "opted_out_at": null,
    "opt_in_method": "api",
    "keyword_name": null,
    "carrier": 383,
    "carrier_name": "Verizon Wireless",
    "global_carrier_id": "12345",
    "global_carrier_name": "Verizon"
  }
}

Request URL

PUT https://app.tatango.com/api/v2/lists/{ID}/subscribers/{SUBSCRIBER_ID}

FAQs

If I add tags to an existing subscriber, does that add the tags to existing, or replace existing?

The tags are added to any tags already applied, not replaced.

Can I update custom subscriber data for a subscriber?

Yes, the paramaters are listed below.

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

integer

required

ID of the list

SUBSCRIBER_ID

string

required

ID of the subscriber (phone number)

Body

application/json

subscriber

object

required

Show child attributes

subscriber.phone_number

string

required

The wireless phone number of the subscriber

Example:

"2141234567"

subscriber.first_name

string

First name - char(50)

Example:

"John"

subscriber.last_name

string

Last name - char(50)

Example:

"Doe"

subscriber.email

string

Email - char(50)

Example:

"[email protected]"

subscriber.birthdate

string

Birthdate - int(6)

Example:

"19900101"

subscriber.zip_code

string

ZIP code - char(6)

Example:

"75201"

subscriber.gender

enum<string>

Gender - char('Male' or 'Female')

Available options:

Male,

Female

Example:

"Male"

subscriber.tags

string

List of tags, comma separated, for example: 'vip customer, card holder, daily alerts'

Example:

"vip customer, card holder, daily alerts"

subscriber.custom_field_key

string

Custom data value

Example:

"custom_value"

Response

200 - application/json

Subscriber updated successfully

status

string

required

Example:

"Subscriber updated"

subscriber

object

required

Show child attributes

subscriber.phone_number

string

required

The wireless phone number of the subscriber

Example:

"2141234567"

subscriber.subscribed_at

string<date-time>

required

Date subscriber first subscribed to this list

Example:

"2025-06-18T15:36:07Z"

subscriber.opt_in_method

string

required

Original opt-in method used

Example:

"api"

subscriber.first_name

string

First name of the subscriber

Example:

"John"

subscriber.last_name

string

Last name of the subscriber

Example:

"Doe"

subscriber.email

string

Email address of the subscriber

Example:

"[email protected]"

subscriber.birthdate

string

Birthdate of the subscriber

Example:

"19900101"

subscriber.zip_code

string

ZIP code of the subscriber

Example:

"75201"

subscriber.gender

string

Gender of the subscriber

Example:

"Male"

subscriber.cleaned_at

string<date-time> | null

Date/time of automatic unsubscription (if applicable)

subscriber.opted_out_at

string<date-time> | null

Date subscriber last unsubscribed from this list

subscriber.keyword_name

string | null

Keyword used for opt-in (if applicable)

subscriber.carrier

integer

Wireless carrier ID

Example:

383

subscriber.carrier_name

string

Wireless carrier name

Example:

"Verizon Wireless"

subscriber.global_carrier_id

string

Global wireless carrier ID

Example:

"12345"

subscriber.global_carrier_name

string

Global wireless carrier name

Example:

"Verizon"

subscriber.tags

string[]

List of tags associated with the subscriber

Example:

["vip", "customer"]

subscriber.total_messages_received

integer

The total amount of mass messages this specific subscriber has received over their lifetime from this specific list

Example:

15

Getting a Subscriber Adding Multiple Tags to Multiple Subscribers

⌘I

v2 API Reference

Accounts

Lists

Subscribers

Custom Fields

Tags

Messaging

Message Log (MOMT) Reports

Shortcodes

Transactional Messages

Webhooks

Updating a Subscriber

Request URL

FAQs

Authorizations

Path Parameters

Body

Response

v2 API Reference

Accounts

Lists

Subscribers

Custom Fields

Tags

Messaging

Message Log (MOMT) Reports

Shortcodes

Transactional Messages

Webhooks

​Request URL

​FAQs

Authorizations

Path Parameters

Body

Response

Request URL

FAQs