Skip to main content
GET
/
automations
curl --request GET \
  --url 'https://api.autosend.com/v1/automations?status=active&tags=onboarding&page=1&limit=20' \
  --header 'Authorization: Bearer AS_your-project-api-key'

{
  "success": true,
  "data": {
    "workflowAutomations": [
      {
        "id": "60d5ec49f1b2c72d9c8b9abc",
        "name": "Welcome Series",
        "status": "active",
        "entryCriteria": { "type": "contact_created" },
        "exitCriteria": { "type": "workflow_complete" },
        "steps": [],
        "tags": ["onboarding"],
        "trackingOpen": true,
        "trackingClick": true,
        "createdBy": {
          "id": "60d5ec49f1b2c72d9c8b3333",
          "firstName": "Jane",
          "lastName": "Doe"
        },
        "analytics": {
          "totalEntered": 1250,
          "totalCompleted": 980,
          "totalExited": 40,
          "totalActive": 230,
          "sent": 2100,
          "delivered": 2050,
          "opened": 1320,
          "clicked": 410,
          "bounced": 12
        },
        "activeAt": "2026-05-08T10:00:00.000Z",
        "createdAt": "2026-05-01T08:00:00.000Z",
        "updatedAt": "2026-05-08T10:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "pages": 1
    }
  }
}
Returns a paginated list of workflow automations for the project, with optional filtering by status and comma-separated tags.
curl --request GET \
  --url 'https://api.autosend.com/v1/automations?status=active&tags=onboarding&page=1&limit=20' \
  --header 'Authorization: Bearer AS_your-project-api-key'

{
  "success": true,
  "data": {
    "workflowAutomations": [
      {
        "id": "60d5ec49f1b2c72d9c8b9abc",
        "name": "Welcome Series",
        "status": "active",
        "entryCriteria": { "type": "contact_created" },
        "exitCriteria": { "type": "workflow_complete" },
        "steps": [],
        "tags": ["onboarding"],
        "trackingOpen": true,
        "trackingClick": true,
        "createdBy": {
          "id": "60d5ec49f1b2c72d9c8b3333",
          "firstName": "Jane",
          "lastName": "Doe"
        },
        "analytics": {
          "totalEntered": 1250,
          "totalCompleted": 980,
          "totalExited": 40,
          "totalActive": 230,
          "sent": 2100,
          "delivered": 2050,
          "opened": 1320,
          "clicked": 410,
          "bounced": 12
        },
        "activeAt": "2026-05-08T10:00:00.000Z",
        "createdAt": "2026-05-01T08:00:00.000Z",
        "updatedAt": "2026-05-08T10:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "pages": 1
    }
  }
}

​
Authorizations

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

​
Query Parameters

​
status
string
Filter by workflow status. One of draft, active, paused, or archived.
​
tags
string
Comma-separated list of tags to filter by.Example: "onboarding,trial"
​
page
integer
Page number (1-indexed). Default 1.
​
limit
integer
Page size. Default 50, maximum 100.

​
Response

Workflow automations retrieved successfully
​
success
boolean
Example: true
​
data
object