Visit api.envoke.com to test APIs and get examples in 20+ languages

Note that tags and subscriptions in the API are referred to as "interests" to match the contacts API.

NOTE: this is a version 2 API, and requires /v2/ in the route.

Return all tags and subscriptions

Endpoint: /v2/interests
HTTP method: GET
URL: https://e1.envoke.com/v2/interests

NOTE: All examples below are formatted for readability, actual GET requests require URI encoding. Each example below also includes a cURL request. Make sure to change the API_ID and API_KEY with your values.

Return all tags and subscriptions

https://e1.envoke.com/v2/interests

curl -X GET -u API_ID:API_KEY "https://e1.envoke.com/v2/interests"

Return type

An array of objects containing the tag or subscription data.

The "type" field will have the value "subscription" for subscriptions.

Result example

[  
  {
    "id": "1234",
    "external_id": "7f001a962afec30f0525d0a716bd9d04",
    "type": "interest",
    "name": "Agents",
    "group": "Sales channel",
    "description": "",
    "display_names": {
      "en": "",
      "fr": ""
    }
  }
]

Additional examples

Return subscriptions only:

https://e1.envoke.com/v2/interests?type=subscription

Return the result as a key / value pair like the previous v1 API:

https://e1.envoke.com/v2/interests?type=tag&result_type=kvp

Return results from a specified folder (be sure to URL encode):

https://e1.envoke.com/v2/interests?group=FOLDER%20NAME