Events
List Events
Retrieves all event definitions for the authenticated project.
GET
/
events
curl --request GET \
--url https://api.autosend.com/v1/events \
--header 'Authorization: Bearer AS_your-project-api-key'
{
"success": true,
"data": {
"events": [
{
"id": "60d5ec49f1b2c72d9c8b1234",
"eventName": "order_completed",
"description": "Fired when a customer completes a checkout",
"properties": [
{
"propertyName": "order_total",
"type": "number",
"description": "Total order value in USD",
"suggestedValues": []
},
{
"propertyName": "currency",
"type": "string",
"suggestedValues": ["USD", "EUR", "GBP"]
}
],
"createdAt": "2026-05-08T10:00:00.000Z",
"updatedAt": "2026-05-08T10:00:00.000Z"
},
{
"id": "60d5ec49f1b2c72d9c8b5678",
"eventName": "signup_completed",
"description": null,
"properties": [],
"createdAt": "2026-05-01T08:30:00.000Z",
"updatedAt": "2026-05-01T08:30:00.000Z"
}
]
}
}
Returns every active event definition for the authenticated project, sorted newest-first.
curl --request GET \
--url https://api.autosend.com/v1/events \
--header 'Authorization: Bearer AS_your-project-api-key'
{
"success": true,
"data": {
"events": [
{
"id": "60d5ec49f1b2c72d9c8b1234",
"eventName": "order_completed",
"description": "Fired when a customer completes a checkout",
"properties": [
{
"propertyName": "order_total",
"type": "number",
"description": "Total order value in USD",
"suggestedValues": []
},
{
"propertyName": "currency",
"type": "string",
"suggestedValues": ["USD", "EUR", "GBP"]
}
],
"createdAt": "2026-05-08T10:00:00.000Z",
"updatedAt": "2026-05-08T10:00:00.000Z"
},
{
"id": "60d5ec49f1b2c72d9c8b5678",
"eventName": "signup_completed",
"description": null,
"properties": [],
"createdAt": "2026-05-01T08:30:00.000Z",
"updatedAt": "2026-05-01T08:30:00.000Z"
}
]
}
}
Authorizations
Project API key header of the form Bearer
AS_<key>.Response
Events retrieved successfullyIndicates if the request was successfulExample:
trueShow child attributes
Show child attributes
Array of event definitions belonging to the project
Show child attributes
Show child attributes
Unique event definition identifier
Event nameExample:
"order_completed"Human-readable description
ISO 8601 timestamp of creation
ISO 8601 timestamp of last update
⌘I
curl --request GET \
--url https://api.autosend.com/v1/events \
--header 'Authorization: Bearer AS_your-project-api-key'
{
"success": true,
"data": {
"events": [
{
"id": "60d5ec49f1b2c72d9c8b1234",
"eventName": "order_completed",
"description": "Fired when a customer completes a checkout",
"properties": [
{
"propertyName": "order_total",
"type": "number",
"description": "Total order value in USD",
"suggestedValues": []
},
{
"propertyName": "currency",
"type": "string",
"suggestedValues": ["USD", "EUR", "GBP"]
}
],
"createdAt": "2026-05-08T10:00:00.000Z",
"updatedAt": "2026-05-08T10:00:00.000Z"
},
{
"id": "60d5ec49f1b2c72d9c8b5678",
"eventName": "signup_completed",
"description": null,
"properties": [],
"createdAt": "2026-05-01T08:30:00.000Z",
"updatedAt": "2026-05-01T08:30:00.000Z"
}
]
}
}