Subscribers

This end point returns a list of your subscribers (subscribed and unsubscribed). Search subscribers by email address by providing an email query parameter.

get
Get Subscriber(s)
https://app.bentonow.com/api/v1/fetch/subscribers
Fetch one (or many) visitors with email addresses in your account.
Request
Response
Request
Headers
Basic Auth
required
string
publishable_key:secret_key
Query Parameters
page
optional
string
The page of subscribers you wish to fetch.
site_uuid
required
string
Your site's unique identifier. 
email
optional
string
This will return a subscriber if it exists in your account.
Response
200: OK
Returns a list of visitors.
{
  "data": {
    "id": "236",
    "type": "visitors",
    "attributes": {
      "uuid": "0f566d05f47a59bff25f147df3a6233d",
      "email": "[email protected]",
      "fields": {},
      "cached_tag_ids": []
    }
  }
}
post
Create Subscriber
https://app.bentonow.com/api/v1/fetch/subscribers
Creates a subscriber in your account and queues them for indexing.
Request
Response
Request
Headers
Basic Auth
required
string
publishable_key:secret_key
Query Parameters
site_uuid
required
string
Your site's unique identifier.
Body Parameters
subscriber
required
object
{ "email": "[email protected]" }
Response
200: OK
Returns the created visitor.
{
  "data": {
    "id": "236",
    "type": "visitors",
    "attributes": {
      "uuid": "0f566d05f47a59bff25f147df3a6233d",
      "email": "[email protected]",
      "fields": {},
      "cached_tag_ids": []
    }
  }
}
​

Account Management - Previous

Sites

Next - API v1 — Fetch Endpoint

Subscribers

getGet Subscriber(s)

postCreate Subscriber

get
Get Subscriber(s)

post
Create Subscriber