Retrieve Workflows - Leadfeeder API

Retrieve the account's workflows as a paginated list, each with its complete definition of triggers and steps.

Only workflows belonging to the account given by account_id are ever returned, and only those the authenticated user is allowed to see.

Use include to pull in the user who created a workflow, the user who turned it off, its recent run statistics, or the errors it has run into.

Credit Note: Retrieving workflows does not consume credits.

INFO

Requires the workflows:read OAuth2 scope.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Success

Bodyapplication/json

Example

{
    "data": [
        {
            "type": "workflow",
            "id": "9f8b7c6d5e4f",
            "attributes": {
                "name": "Route hot leads to Slack",
                "description": "Notifies #sales whenever a company lands on the Hot Leads list.",
                "enabled": true,
                "workflow_type": "company",
                "version": 3,
                "definition_version": "V1",
                "definition": {
                    "triggers": [
                        {
                            "name": "company_added_to_list",
                            "filters": [
                                {
                                    "attribute": "list_id",
                                    "op": "eq",
                                    "value": "42"
                                }
                            ],
                            "options": {}
                        }
                    ],
                    "steps": {
                        "notify_sales": {
                            "action_name": "send_company_to_slack",
                            "options": {
                                "channel": "#sales"
                            }
                        }
                    },
                    "order": {
                        "trigger": [
                            "notify_sales"
                        ]
                    }
                },
                "has_errors": false,
                "disabled_at": null,
                "disabled_reason": null,
                "created_at": "2026-07-20T09:15:00Z",
                "updated_at": "2026-08-01T10:00:00Z",
                "app_url": "https://app.leadfeeder.com/z/123456/workflows/9f8b7c6d5e4f"
            },
            "relationships": {
                "created_by": {
                    "id": "123456",
                    "type": "user"
                },
                "disabled_by": null
            }
        }
    ],
    "meta": {
        "credits": {
            "charged": 0
        },
        "pagination": {
            "next_cursor": null,
            "total_count": 1
        },
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429

🔴500Server Error

🔴504Gateway Timeout