Skip to main content
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" },
    "steps": [
      { "stepId": "step_aa11", "type": "wait", "delay": { "value": 0, "unit": "minutes" } },
      { "stepId": "step_bb22", "type": "email", "email": { "templateId": "60d5ec49f1b2c72d9c8b1234" } }
    ],
    "tags": ["onboarding"],
    "trackingOpen": true,
    "trackingClick": true,
    "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" },
    "steps": [
      { "stepId": "step_aa11", "type": "wait", "delay": { "value": 0, "unit": "minutes" } },
      { "stepId": "step_bb22", "type": "email", "email": { "templateId": "60d5ec49f1b2c72d9c8b1234" } }
    ],
    "tags": ["onboarding"],
    "trackingOpen": true,
    "trackingClick": true,
    "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

​
Authorizations
string | header
required
Project API key header of the form Bearer AS_<key>.

​
Path Parameters

​
id
string
required
Workflow automation ID (MongoDB ObjectId).Example: "60d5ec49f1b2c72d9c8b9abc"

​
Response

Workflow automation retrieved successfully
​
success
boolean
Example: true
​
data
object
The workflow automation, with email-step templateId references enriched with template metadata where applicable.

​
Error Responses

​
404 - Workflow not found
object
{
  "success": false,
  "error": {
    "message": "Workflow automation not found",
    "code": "WORKFLOW_NOT_FOUND"
  }
}