1. Workflows
Leadfeeder API
  • Leadfeeder API
  • Authentication
  • Getting Started
  • Rate Limits
  • Relationships
  • Company ID Lifecycle
  • OpenAPI Specification Access
  • List of NACE / WZ codes
  • List of Industries
  • AI & MCP (Beta)
    • Overview of the Leadfeeder MCP Server
    • Quickstart
    • Connect your AI tool
    • Authentication and permissions
  • Account
    • List Accounts
  • Companies
    • Get Company Details
    • Update a Company
    • Retrieve Companies
    • Company Financial Reports
    • Retrieve Company IPs
    • Search Company Signals
    • Search Companies
    • Match Companies
    • Add Company to Lists
    • Remove Company from Lists
    • Assign Tags to Company
    • Unassign Tags from Company
    • Estimate Company Enrichment Job
    • Create Company Enrichment Job
    • Get Company Enrichment Job Status
  • Contacts
    • Get Contact Details
    • Update a Contact
    • Retrieve Contacts
    • Search Contacts
    • Add Contact to Lists
    • Remove Contact from Lists
    • Estimate Find Contact Data Job
    • Create Find Contact Data Job
    • Get Find Contact Data Job Status
  • Web Visits
    • How to Create Custom Feed
    • Custom Feed - Filter Reference
    • Search Web Visits
    • Retrieve Custom Feeds
    • Create a Custom Feed
    • Get Custom Feed Details
    • Update Custom Feed
    • Delete a Custom Feed
    • Retrieve Custom Feeds Folders
    • Retrieve Web Visits Tracker Script
    • Retrieve Visitor Companies
  • Campaigns
    • Retrieve Campaigns
    • Get Campaign Details
    • Update Campaign
    • Retrieve Campaign Stats
  • IP
    • Enrich Company IP Address
  • Buyer Personas
    • Retrieve Buyer Personas
    • Create a Buyer Persona
    • Get Buyer Persona Details
    • Update a Buyer Persona
    • Delete a Buyer Persona
  • Ideal Customer Profiles
    • Retrieve Ideal Customer Profiles
    • Create an Ideal Customer Profile
    • Get Ideal Customer Profile Details
    • Update an Ideal Customer Profile
    • Delete an Ideal Customer Profile
    • Retrieve Company ICP Matches
  • Tags
    • Retrieve Tags
    • Create Tag
    • Get Tag Details
    • Update Tag
    • Delete Tag
    • Create Batch Add Tags Job
    • Get Batch Add Tags Job
    • Create Batch Remove Tags Job
    • Get Batch Remove Tags Job
  • Lists
    • Retrieve Lists
    • Create a List
    • Get List Details
    • Update List
    • Delete List
    • Retrieve List Items
    • Retrieve Company List Memberships
    • Retrieve Contact List Memberships
    • Create Batch Add to List Job
    • Get Batch Add to List Job
    • Create Batch Remove from List Job
    • Get Batch Remove from List Job
  • Custom Fields
    • Retrieve Custom Fields
    • Create Custom Field
    • Get Custom Field Details
    • Update Custom Field
    • Delete Custom Field
  • Users
    • Get Current User
  • Usage
    • Get Endpoints Usage
  • Workflows
    • Retrieve Workflows
      GET
    • Create Workflow
      POST
    • Retrieve Workflow Action Definitions
      GET
    • Retrieve Workflow Trigger Definitions
      GET
    • Retrieve Workflow Templates
      GET
    • Get Workflow Details
      GET
    • Update Workflow
      PATCH
  • Reference Data
    • Get Geo Suggestions
    • Get Countries with Regions
  • Schemas
    • AccountCompanyV1
    • AccountV1
    • AccountSummaryV1
    • CompanyV1
    • ErrorObjectV1
    • ICPV1
    • CompanyFinancialsV1
    • IpAddressExtendedV1
    • UserV1
    • CompaniesAdvancedSearchFilterItem
    • ContactFilterGroupsV1
    • BuyerPersonaV1
    • ContactV1
    • EnrichmentJobV1
    • GeoSuggestionV1
    • ContactSummaryV1
    • MaskedContactSummaryV1
    • TagV1
    • ListV1
    • IcpRequestV1
    • VisitLocationV1
    • BuyerPersonaRequestV1
    • WebVisitV1
    • BatchAddTagsJobV1
    • BatchRemoveTagsJobV1
    • CRMUserV1
    • CRMOrganizationV1
    • EnrichedIpV1
    • CRMContactV1
    • CRMLeadV1
    • CRMConnectionV1
    • CustomFeedRequestV1
    • CRMSuggestionV1
    • CRMGroupConnectionV1
    • WorkflowV1
    • WorkflowActionDefinitionV1
    • CompanyIpV1
    • WorkflowTriggerDefinitionV1
    • WorkflowTemplateV1
    • SignalV1
    • CompanySummaryV1
    • MaskedCompanySummaryV1
    • CompanyMatchV1
    • CountryV1
    • FindContactDataJobV1
    • BatchAddToListJobV1
    • CustomFieldV1
    • BatchRemoveFromListJobV1
    • CustomFeedV1
    • CampaignSettingsV1
    • CampaignSummaryV1
    • CampaignLocationV1
    • CampaignV1
    • CampaignStatsV1
    • IpLocationV1
    • NetworkV1
    • ApiUsageV1
    • CustomFeedFolderV1
    • WebVisitsTrackerScriptV1
    • LocationV1
    • CompanyLocationV1
  1. Workflows

Get Workflow Details

GET
/v1/workflows/{id}
Fetch a single workflow in full, including its complete definition of triggers and steps.
Use include to pull in the user who created it, the user who turned it off, its recent run statistics, and the errors it has run into.
A workflow belonging to another account is never returned — the request fails with 404 instead.
Credit Note: Retrieving a workflow does not consume credits.
INFO
Requires the workflows:read OAuth2 scope.

Request

Authorization
API Key
Add parameter in header
X-Api-Key
Example:
X-Api-Key: ********************
or
Path Params

Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.leadfeeder.com/v1/workflows/9f8b7c6d5e4f?account_id=123456&include=created_by%2Crun_stats%2Cerrors' \
--header 'X-Api-Key: <api-key>'

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": {
                    "enrich": {
                        "action_name": "enrich_company",
                        "options": {}
                    },
                    "notify_sales": {
                        "action_name": "send_company_to_slack",
                        "options": {
                            "channel": "#sales"
                        }
                    }
                },
                "order": {
                    "trigger": [
                        "enrich"
                    ],
                    "enrich": [
                        {
                            "step_if_true": "notify_sales",
                            "step_else": null,
                            "cliftonite_filters": {
                                "organization_employee_count": {
                                    "gte": 50
                                }
                            }
                        }
                    ]
                }
            },
            "has_errors": true,
            "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": {
                "type": "user",
                "id": "123456",
                "attributes": {
                    "email": "jane.smith@example.com",
                    "first_name": "Jane",
                    "last_name": "Smith",
                    "phone_number": "+49 721 50057501",
                    "country_code": "DE",
                    "team_role": "admin"
                }
            },
            "disabled_by": null,
            "run_stats": {
                "type": "workflow_run_stats",
                "id": "9f8b7c6d5e4f",
                "attributes": {
                    "triggered_count": 128,
                    "failed_count": 3,
                    "last_run_at": "2026-08-05T14:22:31Z"
                }
            },
            "errors": [
                {
                    "type": "workflow_error",
                    "id": "7d3f1a90c2b4e6f8",
                    "attributes": {
                        "step_id": "notify_sales",
                        "error_code": "connection_unauthorized",
                        "error_message": "The Slack connection is no longer authorised.",
                        "count": 3,
                        "first_seen_at": "2026-07-29T08:03:00Z",
                        "last_seen_at": "2026-08-05T14:22:31Z"
                    }
                }
            ]
        }
    },
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
🟠429
🔴500Server Error
🔴504Gateway Timeout
Modified at 2026-08-31 12:06:53
Previous
Retrieve Workflow Templates
Next
Update Workflow
Built with