Get Actions for Flow

get https://a.klaviyo.com/api/flows/{id}/flow-actions

🚧
This endpoint is in beta and subject to change.
A beta revision header (2025-04-15.pre) is required to use our beta APIs. Klaviyo APIs in beta are not intended for use in production. See our versioning and deprecation policy for more information.

Get all flow actions associated with the given flow ID.

Returns a maximum of 50 flows per request, which can be paginated with cursor-based pagination.

Rate limits:
Burst: 3/s
Steady: 60/m

Scopes:
flows:read

Path Params

string

required

Query Params

fields[flow-action]

array of strings

For more information please visit https://developers.klaviyo.com/en/v2025-04-15.pre/reference/api-overview#sparse-fieldsets

fields[flow-action]

filter

string

For more information please visit https://developers.klaviyo.com/en/v2025-04-15.pre/reference/api-overview#filtering
Allowed field(s)/operator(s):
id: any
action_type: any, equals
status: equals
created: equals, greater-or-equal, greater-than, less-or-equal, less-than
updated: equals, greater-or-equal, greater-than, less-or-equal, less-than

page[cursor]

string

For more information please visit https://developers.klaviyo.com/en/v2025-04-15.pre/reference/api-overview#pagination

page[size]

integer

1 to 50

Defaults to 50

Default: 50. Min: 1. Max: 50.

sort

string

For more information please visit https://developers.klaviyo.com/en/v2025-04-15.pre/reference/api-overview#sorting

Headers

revision

string

required

Defaults to 2025-04-15.pre

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

Language

Credentials

Header


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://a.klaviyo.com/api/flows/id/flow-actions?page[size]=50' \
3
     --header 'Authorization: Klaviyo-API-Key your-private-api-key' \
4
     --header 'accept: application/vnd.api+json' \
5
     --header 'revision: 2025-04-15.pre'


xxxxxxxxxx
44
}
1
{
2
  "data": [
3
    {
4
      "type": "flow-action",
5
      "id": "string",
6
      "attributes": {
7
        "created": "2022-11-08T00:00:00+00:00",
8
        "updated": "2022-11-08T00:00:00+00:00",
9
        "definition": {
10
          "id": "123",
11
          "temporary_id": "action-1",
12
          "type": "back-in-stock-delay",
13
          "links": {
14
            "next": "string"
15
          }
16
        }
17
      },
18
      "links": {
19
        "self": "string"
20
      },
21
      "relationships": {
22
        "flow": {
23
          "links": {
24
            "self": "string",
25
            "related": "string"

200Success

4XXClient Error

5XXServer Error