List all tags on a given Channel

List of tags for the given channel.
You can use tags to organize subscribers into groups. For example, you could add a tag for a city, state, acquisition channel or subscriber state. Should you choose, you can then use these tags to determine what message is sent to which subscribers at a given time.

Note that tags are referred to as groups in the Essential user interface.

Resource URL:


Resource information:

Response formatJSON
Requires authentication?Yes



Whether or not deleted tags should be included in the response.

Sample code:

curl -X GET \
     -u '[SID]:[TOKEN]' \
     '' \
     -G -d 'include_deleted=true'

# Sample response
    "name": "Labrador lovers",
    "created_at": "2016-12-10T01:32:59.000Z",
    "updated_at": "2016-12-25T016:20:00.000Z",
    "canonical_name": "labrador_lovers",
    "deleted_at": null,
    "sid": "tRhvpNDGZwyDeH-YRZIr9A",
    "account_sid": "RsbrYCSo2m0sShMLOlZqtw",
    "channel_sid": "sRhvpNDGZwyDeH-YRZIr9A",
    "num_subscribers_total": 200,
    "num_subscribers_active": 198
Python coming soon.
Node coming soon.