Online
Bento

Tags

Tags are labels for organizing people and triggering automation. Use this API to list, create, and discard tag definitions. To add or remove tags from a subscriber, use Subscriber Commands or the batch subscriber import endpoint.

Available Endpoints

The Tag Model

The tag model is a simple named data point you can use to tag subscribers.

Properties

  • Name
    namestring
    Description

    The name of the tag


GET/v1/fetch/tags

Get Tags

Returns a list of tags in your account.



Response

Returns a list of Tags in your account.

  • Name
    dataarray
    Description

    Tag records in your account.

  • Name
    data[].namestring
    Description

    Tag name.


POST/v1/fetch/tags

Create Tag

Creates a custom tag in your account.

Required Attributes

  • Name
    namestring
    Description

    The name of the tag to create.



Response

Returns the details of the created Tag.

  • Name
    data.namestring
    Description

    Name of the created tag.


DELETE/v1/fetch/tags

Delete Tag

Discards a tag in your account.

Required Attributes

  • Name
    namestring
    Description

    The name of the tag to discard.



Response

Returns the discarded tag details or a success response depending on account configuration.

  • Name
    data.namestring
    Description

    Name of the discarded tag when returned.