How to Work with Webhooks

ClickFunnels webhooks allow you to react to many events in the ClickFunnels app on your own server,
Zapier and other similar tools.

To receive webhooks from ClickFunnels you first need to choose the events that you would like to watch (please use the list below to see all available webhooks). Then, you need to configure a webhooks endpoint as explained in the next section.

Configure Webhook Endpoints

You need to configure one or more webhook endpoints within the ClickFunnels API by using the Webhooks::Outgoing::Endpoints
endpoint with the event_type_ids that you want to listen to (see below for all types).

Keep in mind that users may also configure webhook endpoints in the UI.

Understanding Event Data

Once configured, you will receive POST requests from us to the configured endpoint URL with the
Webhooks::Outgoing::Event
payload, that will contain the subject payload in the data property. Like here for the
contact.identified webhook in V2 version:

{
  "data": {
    "id": 236296209,
    "tags": [

    ],
    "uuid": "31cabea548c19c0495106323678abcac",
    "fb_url": null,
    "anonymous": 0,
    "last_name": "Dullan",
    "public_id": "BbBNRxw",
    "time_zone": null,
    "created_at": "2024-04-04T19:16:30.660Z",
    "first_name": "Bob",
    "updated_at": "2024-04-04T19:16:45.253Z",
    "twitter_url": null,
    "website_url": null,
    "linkedin_url": null,
    "phone_number": "+18472555555",
    "workspace_id": 42,
    "email_address": "[email protected]",
    "instagram_url": null,
    "unsubscribed_at": null,
    "custom_attributes": {
    },
    "last_notification_email_sent_at": null
  },
  "event_id": "123b4741-3f2d-431a-90d1-ddca0f4d6721",
  "event_type": "contact.identified",
  "subject_id": 236296209,
  "subject_type": "Contact",
  "created_at": "2024-04-04T19:16:31.000Z"
}

Bear in mind that the webhooks payload that is emitted is similar but differs slightly from our Webhooks::Outgoing::Event API resource.

The content of the data property will vary depending on the event type that you are receiving.

Event types are structured like this: subject.action. So, for a contact.identified webhook, your
data payload will contain data that you can source from the contact response schema/example in the
documentation. Similarly, for
webhooks like order.created and one-time-order.identified, you will find the documentation in
the Order resource description.

V1 webhooks

Keep in mind that V1 webhooks data have different payloads. V1 webhooks are deprecated, so it's encouraged that you use V2 webhooks where possible.