Automations
Get Automation
Retrieves a single workflow automation by its ID.
GET
/
automations
/
{id}
curl --request GET \
--url https://api.autosend.com/v1/automations/60d5ec49f1b2c72d9c8b9abc \
--header 'Authorization: Bearer AS_your-project-api-key'
{
"success": true,
"data": {
"id": "60d5ec49f1b2c72d9c8b9abc",
"projectId": "60d5ec49f1b2c72d9c8b1111",
"name": "Welcome Series",
"description": "Sends a 2-email welcome flow when a contact is created",
"status": "active",
"entryCriteria": { "type": "contact_created" },
"exitCriteria": { "type": "workflow_complete" },
"trackingOpen": true,
"trackingClick": true,
"settings": {
"maxExecutionDays": 60,
"allowReentry": false,
"timezone": "UTC",
"priority": 1
},
"steps": [
{ "stepId": "step_aa11", "type": "wait", "delay": { "value": 0, "unit": "minutes" } },
{ "stepId": "step_bb22", "type": "email", "email": { "templateId": "60d5ec49f1b2c72d9c8b1234" } }
],
"tags": ["onboarding"],
"analytics": {
"totalEntered": 1250,
"totalCompleted": 980,
"totalExited": 40,
"totalActive": 230
},
"activeAt": "2026-05-08T10:00:00.000Z",
"createdAt": "2026-05-01T08:00:00.000Z",
"updatedAt": "2026-05-08T10:00:00.000Z"
}
}
Retrieves a single workflow automation by its ID, including its full
steps graph and live analytics.curl --request GET \
--url https://api.autosend.com/v1/automations/60d5ec49f1b2c72d9c8b9abc \
--header 'Authorization: Bearer AS_your-project-api-key'
{
"success": true,
"data": {
"id": "60d5ec49f1b2c72d9c8b9abc",
"projectId": "60d5ec49f1b2c72d9c8b1111",
"name": "Welcome Series",
"description": "Sends a 2-email welcome flow when a contact is created",
"status": "active",
"entryCriteria": { "type": "contact_created" },
"exitCriteria": { "type": "workflow_complete" },
"trackingOpen": true,
"trackingClick": true,
"settings": {
"maxExecutionDays": 60,
"allowReentry": false,
"timezone": "UTC",
"priority": 1
},
"steps": [
{ "stepId": "step_aa11", "type": "wait", "delay": { "value": 0, "unit": "minutes" } },
{ "stepId": "step_bb22", "type": "email", "email": { "templateId": "60d5ec49f1b2c72d9c8b1234" } }
],
"tags": ["onboarding"],
"analytics": {
"totalEntered": 1250,
"totalCompleted": 980,
"totalExited": 40,
"totalActive": 230
},
"activeAt": "2026-05-08T10:00:00.000Z",
"createdAt": "2026-05-01T08:00:00.000Z",
"updatedAt": "2026-05-08T10:00:00.000Z"
}
}
Authorizations
Project API key header of the form Bearer
AS_<key>.Path Parameters
Workflow automation ID.Example:
"60d5ec49f1b2c72d9c8b9abc"Response
Workflow automation retrieved successfullyExample:
trueThe workflow automation, with email-step
templateId references enriched with template metadata where applicable.Show child attributes
Show child attributes
Unique workflow identifier.
Project the workflow belongs to.
Display name of the workflow.
Optional description.
Current status:
draft, active, paused, or archived.Conditions that determine which contacts enter the workflow.
Conditions that cause contacts to exit the workflow early.
Whether open tracking is enabled.
Whether click tracking is enabled.
Automation configuration settings.
Show settings
Show settings
Maximum number of days a contact can remain active in the workflow.
Whether contacts can re-enter the workflow after completing it.
Timezone used for scheduling steps (e.g.,
UTC).Execution priority when multiple automations are triggered simultaneously.
Full ordered step graph, with email steps enriched with template metadata.
Tags for filtering and organization.
Live engagement metrics (
totalEntered, totalCompleted, totalExited, totalActive).ISO 8601 timestamp when the workflow was last activated.
ISO 8601 creation timestamp.
ISO 8601 last-updated timestamp.
Error Responses
{
"success": false,
"error": {
"message": "Workflow automation not found",
"code": "WORKFLOW_NOT_FOUND"
}
}
⌘I
curl --request GET \
--url https://api.autosend.com/v1/automations/60d5ec49f1b2c72d9c8b9abc \
--header 'Authorization: Bearer AS_your-project-api-key'
{
"success": true,
"data": {
"id": "60d5ec49f1b2c72d9c8b9abc",
"projectId": "60d5ec49f1b2c72d9c8b1111",
"name": "Welcome Series",
"description": "Sends a 2-email welcome flow when a contact is created",
"status": "active",
"entryCriteria": { "type": "contact_created" },
"exitCriteria": { "type": "workflow_complete" },
"trackingOpen": true,
"trackingClick": true,
"settings": {
"maxExecutionDays": 60,
"allowReentry": false,
"timezone": "UTC",
"priority": 1
},
"steps": [
{ "stepId": "step_aa11", "type": "wait", "delay": { "value": 0, "unit": "minutes" } },
{ "stepId": "step_bb22", "type": "email", "email": { "templateId": "60d5ec49f1b2c72d9c8b1234" } }
],
"tags": ["onboarding"],
"analytics": {
"totalEntered": 1250,
"totalCompleted": 980,
"totalExited": 40,
"totalActive": 230
},
"activeAt": "2026-05-08T10:00:00.000Z",
"createdAt": "2026-05-01T08:00:00.000Z",
"updatedAt": "2026-05-08T10:00:00.000Z"
}
}