Tags

Tags are essential data labels that empower you to effortlessly monitor a subscriber's journey, such as whether they have made a purchase, completed an onboarding step, or advanced through a drip campaign. These versatile tags allow you to not only segment but also perform detailed queries on the users they are assigned to. By leveraging tags, you can create highly targeted marketing strategies, personalize user experiences, and gain deeper insights into customer behavior. The ability to dynamically apply and update tags ensures that you maintain an up-to-date and actionable view of your audience.

Available Endpoints

Method	Endpoint	Name
POST	fetch/tags	Create Tags
GET	fetch/tags	Get Tags

The Tag Model

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

Properties

Name
name
Type
string
Description
The name of the tag

GET/v1/fetch/tags

Get Tags

Returns a list of tags in your account.

Request

GET

/v1/fetch/tags

curl -L -X GET 'https://app.bentonow.com/api/v1/fetch/tags?site_uuid=ExampleID1234' \
-H 'Accept: application/json' \
-H 'Authorization: Basic BASE64ENCODE(USERNAME+PASSWORD)'

Response

Returns a list of Tags in your account.

JSON Response

{
  "data": [
      {
        "id": "1234",
        "type": "tags",
        "attributes": {
          "name": "example_tag",
          "created_at": "2024-08-06T05:44:04.444Z",
          "discarded_at": null
        }
      }
  ]
}

POST/v1/fetch/tags

Create Tag

Creates a custom tag in your account.

Only a single tag can be created at a time.

Required Attributes

Name
name
Type
string
Description
The name of the tag to create.

Request

POST

/v1/fetch/tags

curl -L -X POST 'https://app.bentonow.com/api/v1/fetch/tags?site_uuid=ExampleID1234' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Basic BASE64ENCODE(USERNAME+PASSWORD)' \
--data-raw '{
  "tag": {
    "name": "example"
  }
}'

Response

Returns the details of the created Tag.

JSON Response

"data": [
  {
    "id": "1234",
    "type": "tags",
    "attributes": {
      "name": "example_tag",
      "created_at": "2024-08-06T05:44:04.444Z",
      "discarded_at": null
    }
  }
]