Home/HighLevel/Features/Workflows/How to configure the Custom Webhook action in HighLevel

Workflows and Automation

How to configure the Custom Webhook action in HighLevel

In short

The Custom Webhook action lets you send tailored HTTP requests from a HighLevel workflow to any external URL. You can pick the request method, set authorization, add headers and query strings, and map any workflow data to the payload, enabling real time data exchange with third party services.

AreaWorkflows · Workflow Builder
Used forMarketing agency, SaaS startup, Ecommerce store
PlanAny Plan ($97, $970, $297, $2970, $497, $4970)
Setup steps5 steps in 1 task
Last updatedNovember 16, 2026

01Who this is for

  • Marketers who need to push lead information to advertising platforms without manual entry.
  • Developers who want to integrate the system with custom APIs for automated data sync.
  • IT professionals managing multiple systems and require reliable real time notifications from HighLevel.

02Custom webhook workflow actions, explained

The Custom Webhook is a premium workflow action that creates a direct HTTP call from a contact’s workflow step to an external endpoint. It accepts any URL, supports standard HTTP verbs, and offers several authorization options. You can attach custom headers, query parameters, and map workflow variables into the request body.

The action runs as soon as a contact reaches the step in the workflow. If the API returns an error, the action fails, is skipped, or retries using exponential backoff. Server side limits and API response status must be considered to avoid execution errors.

The feature lives under the workflow actions menu and is available once Premium Actions & Triggers are turned on in the Agency settings. After enabling, both existing and new subaccounts receive 100 free executions.

03How businesses use custom webhook workflow action

  • Marketing agency. The agency adds a Custom Webhook action to a lead capture workflow, sets the URL of the ad platform's API, selects POST, includes an API key header, and maps lead fields into the JSON body. This sends lead data right away to the advertising system.
  • SaaS startup. The startup configures a webhook that fires when a user upgrades. It selects the billing service endpoint, uses Bearer token authorization, adds a Content Type header, and maps the user ID and plan tier into the request. The external service records the upgrade in real time.
  • Ecommerce store. The store creates a webhook in the order confirmation workflow, points to a shipping provider's API, chooses PUT, adds necessary authentication headers, and includes order ID and shipping address as query parameters. The provider receives the data immediately for fulfillment.

04The numbers and rules that matter

  • Agencies on Any Plan ($97, $970, $297, $2970, $497, $4970) can access LC Premium Triggers & Actions (per HighLevel's help center, checked November 2026).
  • Once Premium Actions & Triggers are enabled via the Agency settings, Existing and New Subaccounts will have 100 free executions.

05Before you start

  • Premium Actions & Triggers must be enabled in Agency settings.
  • Existing and new subaccounts receive 100 free executions after enablement.
  • If you want to avoid costs for existing subaccounts, enable rebilling manually for each subaccount in the Agency view.

06How to set up and use custom webhook workflow action in HighLevel

Configure a custom webhook action

  1. Enter the target URL in the Url field.
  2. Choose the HTTP method you need, such as POST, GET, DELETE, PUT, PATCH, HEAD, or OPTIONS.
  3. Select the appropriate Authorization Method for the request.
  4. Add any required Headers and Query Parameters to the request.
  5. Map the data you want to send using the custom values textbox, leveraging autocomplete suggestions.

07What it looks like in HighLevel

08Settings that matter

  • Url. Specifies the endpoint address that receives the HTTP request.
  • Method. Determines which HTTP verb (POST, GET, DELETE, PUT, PATCH, HEAD, OPTIONS) is used.
  • Authorization Method. Defines how the request authenticates with the external service.
  • Headers. Allows extra key value pairs to be sent with the request, such as authentication tokens or content type.
  • Query Parameters. Enables additional parameters to be appended to the URL for filtering or modifying the response.

09Things to know before you rely on it

  • Existing and new subaccounts receive a quota of 100 free executions for the Custom Webhook action.
  • If the receiving server cannot handle the number of executions, errors may occur due to exceeded limits.
  • Failed API responses cause the action to be marked as Failed and may trigger retries with exponential backoff.

10If something goes wrong

  • The action fails and shows an error in the workflow execution log.. Confirm that the target server can accept the volume of requests and that the API returns a successful response.

11How it connects to the rest of HighLevel

Michael's take

Michael Reimer
Michael ReimerFounder of CRM Pros, HighLevel Commander and Certified Admin

Custom webhooks can be a source of hidden trouble if the external endpoint can’t keep up with the volume of calls your workflow generates. A missed response or a rate limit hit will pause or fail the contact’s path, so you need to confirm the target can handle the load.

When it works, the feature gives you real time, programmable links between HighLevel and any system you care about. You can push data, fire alerts or update third party tools without the need for coding, and the autocomplete saves you from mistyping field names.

Get More InformationOpens on HighLevelPublished November 2, 2026 · Updated November 16, 2026

Common questions

Common questions about custom webhook workflow action.

What does the Custom Webhook workflow action do?

It sends a tailored HTTP request from a HighLevel workflow step to any URL you specify, using chosen methods, authorization, headers, and mapped data.

Which HTTP methods can I use with the Custom Webhook action?

You may select POST, GET, DELETE, PUT, PATCH, HEAD, or OPTIONS depending on the needs of the target API.

How many free executions are provided for the Custom Webhook action?

Each subaccount receives 100 free executions once Premium Actions & Triggers are enabled.

What happens if the API returns an error?

The action is marked as Failed, may be skipped, or retried with exponential backoff, and the error appears in the contact’s workflow execution record.

Do I need to enable anything before using the Custom Webhook action?

Yes, Premium Actions & Triggers must be turned on in the Agency settings, and rebilling may need to be set for existing subaccounts if you wish to avoid charges.

Can I add custom headers and query parameters to the request?

Yes, you can include both headers and query parameters to provide additional information or filter the response from the webhook endpoint.

Next step

Pick the features that matter. Then get the plan that unlocks them.

Explore the features you want, start with the five at the top, and upgrade through my link when you are ready. The bonuses and the team come with it.

The features directory explains every HighLevel feature in plain English. Browse it to see what the platform can do.

Back to the FeaturesSee the full details
⌃

Site preview

Explore the next page

This destination is reserved in the page inventory and is not built yet.