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
      • Create Workflow
      • Retrieve Workflow Action Definitions
      • Retrieve Workflow Trigger Definitions
      • Retrieve Workflow Templates
      • Get Workflow Details
      • Update Workflow
    • 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

    WorkflowV1

    {
        "type": "workflow",
        "id": "9f8b7c6d5e4f",
        "attributes": {
            "name": "Route hot leads to Slack",
            "description": "Notifies #sales whenever a company lands on the Hot Leads list.",
            "enabled": false,
            "workflow_type": null,
            "version": 3,
            "definition_version": "V1",
            "definition": {
                "triggers": [
                    {
                        "name": "company_added_to_list",
                        "filters": [
                            {
                                "attribute": "list_id",
                                "op": "eq",
                                "value": "42"
                            }
                        ],
                        "options": {
                            "type": "list"
                        }
                    }
                ],
                "steps": {
                    "add_to_hot_leads": {
                        "action_name": "add_organization_to_list",
                        "options": {
                            "list_id": "42"
                        }
                    },
                    "notify_sales": {
                        "action_name": "send_company_to_slack",
                        "options": {
                            "channel": "#sales"
                        }
                    }
                },
                "order": {
                    "trigger": [
                        "add_to_hot_leads"
                    ],
                    "add_to_hot_leads": [
                        "notify_sales"
                    ]
                }
            },
            "has_errors": false,
            "disabled_at": "2026-08-01T10:00:00Z",
            "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": null,
            "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": 12,
                        "first_seen_at": "2026-07-29T08:03:00Z",
                        "last_seen_at": "2026-08-05T14:22:31Z"
                    }
                }
            ]
        }
    }
    Built with