Skip to main content
GET
/
v2
/
automations
/
events
curl --location --request GET 'https://api.audienceful.com/v2/automations/events' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <your-api-key>'

import requests

url = "https://api.audienceful.com/v2/automations/events"
headers = {
    "Content-Type": "application/json",
    "X-Api-Key": "<your-api-key>",
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://api.audienceful.com/v2/automations/events", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": "<your-api-key>",
  },
});
const data = await response.json();
console.log(data);

{
  "data": [
    {
      "id": "aB3xY7dKvQk6HNNtduqrX9",
      "name": "signed_up",
      "triggered_count": 42,
      "properties": [
        { "name": "plan", "type": "string", "required": false }
      ],
      "created_at": "2026-07-04T12:00:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}
Requires the events:read scope. These are the named triggers a workspace defines (e.g. signed_up, purchased) — the events you can fire with Trigger Event, along with the payload properties each one declares. Results are cursor-paginated and ordered by name.

​
Query parameters

​
page_size
number
default:"100"
The number of events to return per page.
​
cursor
string
The pagination cursor from a previous response’s next_cursor. See Pagination.

​
Response

​
data
array
The page of custom event definitions.
​
has_more
boolean
Whether more events exist after this page.
​
next_cursor
string or null
The cursor to pass as ?cursor= to fetch the next page.
curl --location --request GET 'https://api.audienceful.com/v2/automations/events' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <your-api-key>'

import requests

url = "https://api.audienceful.com/v2/automations/events"
headers = {
    "Content-Type": "application/json",
    "X-Api-Key": "<your-api-key>",
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://api.audienceful.com/v2/automations/events", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": "<your-api-key>",
  },
});
const data = await response.json();
console.log(data);

{
  "data": [
    {
      "id": "aB3xY7dKvQk6HNNtduqrX9",
      "name": "signed_up",
      "triggered_count": 42,
      "properties": [
        { "name": "plan", "type": "string", "required": false }
      ],
      "created_at": "2026-07-04T12:00:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}