Automations

List automation workflows

List automation workflows with filtering, sorting, and cursor-based pagination.

Scopes: automations.read

Rate Limiting: This endpoint is rate limited to 400 requests per minute.

Pagination: This endpoint uses cursor-based pagination.

  • Use the paging.cursors.after value from the response to get the next page
  • Use the paging.cursors.before value to get the previous page
  • The paging.hasMore field indicates if more results are available
  • Maximum page size is 250 items. Default: 100

Response shape: Items are always Automation. With view=summary the heavy blocks tree is omitted from every item unless requested with include=blocks; all other fields are unchanged. include has no effect without view=summary.

get/automations

Request

  • Base URL
    https://api.omnisend.com/api
  • URL
    https://api.omnisend.com/api/automations
  • Auth
    • OAuth 2
      Client credentials
      Token URL: https://app.omnisend.com/oauth2/token scopes: automations.read
    • or API key in header Authorization

Query parameters

limitinteger

Number of items per page. Range: 1-250. Default: 100

afterstring

Opaque cursor for the next page

beforestring

Opaque cursor for the previous page

sort'createdAt' | 'updatedAt'

Sort field. Default: createdAt

direction'asc' | 'desc'

Sort direction. Default: desc

isEnabledboolean

If true, only enabled automations; if false, only disabled. Omit for no filter.

nameContainsstring

Filter by name (partial match, max 200 characters)

createdAtFromstring date-time

Filter automations created after this timestamp (ISO 8601, e.g. 2026-01-01T00:00:00Z)

createdAtTostring date-time

Filter automations created before this timestamp (ISO 8601, e.g. 2026-01-01T00:00:00Z)

updatedAtFromstring date-time

Filter automations updated after this timestamp (ISO 8601, e.g. 2026-01-01T00:00:00Z)

updatedAtTostring date-time

Filter automations updated before this timestamp (ISO 8601, e.g. 2026-01-01T00:00:00Z)

view'summary'

Response shape. summary omits the heavy blocks tree from every item. Omit for the full representation.

includestring[]

Heavy sections to keep in summary view (repeatable or comma-separated): blocks (full workflow blocks tree). Only meaningful together with view=summary.

Headers

Omnisend-Versionstring required

API version that specifies the response format and behaviour

Response

List of automations with pagination

Changes

No recorded changes to this operation across all 1 revision of this API.