How to set up a webhook integration for a lead form

A webhook integration allows you to automatically send information from one app to another using a unique URL. You can create a webhook integration to link your lead form to your customer relationship management (CRM) system. After you add a webhook integration to your lead form, you’ll receive your leads directly in your CRM.

To add the webhook integration to your lead form, you'll need to generate a webhook URL and a webhook key.

  • The webhook URL is the delivery path. After a person submits their information in a lead form, an "HTTP POST" request is sent to the configured URL, allowing the leads to go directly to the CRM.
  • The webhook key is used for validating the leads sent.

If you've the ability to do so, you can create the webhook integration and then generate a URL and key for the webhook. Learn more about Generating a webhook URL and key.

Note: You can use a third-party integration provider to automatically send lead form data to your CRM using a webhook. The third-party automatically generates the webhook and applies it to your lead form asset in Google Ads. A paid account may be required to utilize these third-party lead export integrations.

We also have a lead export integration with Zapier that uses the Google Ads API instead of a webhook. You can also manually export lead form data by downloading a CSV file or use the Google Ads API.

How to add a webhook integration to a new lead form asset
  1. Go to Campaigns within the Campaigns menu Campaigns Icon.
  2. Select the plus button , then select New campaign.
  3. Select Leads as your goal.
  4. Select Search, Video, Performance Max, or Display as your campaign type.
  5. Select Continue.
  6. Enter your campaign settings.
  7. Select Create lead form to open the lead form asset editor and to enter details about your lead form.
    • For Search and Display campaigns: Scroll to the “Assets” section, then select More Asset Types and then Lead forms.
    • For Video campaigns: Scroll to the “Lead form” section, then select Form.
  8. Begin creating your lead form asset.
  9. Select to expand “Export leads from Google Ads”, then select to expand “Other data integration options".
  10. Under "Webhook integration (optional)", add your webhook URL and webhook key.
  11. Select Send test data and verify if your CRM receives the data correctly.
  12. When you finish creating the lead form, select Save.
How to add a webhook integration to an existing lead form asset
  1. Go to Assets within the Campaigns menu Campaigns Icon.
  2. You'll now view a table with all your assets. Select Lead form from the list above the table toolbar.
  3. Hover over the lead form and select the pencil icon to edit.
  4. Select to expand “Export leads from Google Ads", then select to expand “Other data integration options".
  5. Under "Webhook integration (optional)", add your webhook URL and webhook key.
  6. Select Send test data and verify if your CRM receives the data correctly.
  7. When you finish editing the lead form, select Save.

Error states

Depending on your initial actions after adding a webhook, you may discover one of the following error states:

  • Error state A: When people save the form without sending test data (successfully).
  • Error state B: Data that isn't sent.
  • Error state C: Data sent without Google receiving a response.
  • Error state D: Data sent, but Google receives an incorrect response (different from "HTTP 200").
  • Success state: Data sent, and Google receives a correct response.

Was this helpful?

How can we improve it?
Search
Clear search
Close search
Main menu
7788416263059437944
true
Search Help Center
true
true
true
true
true
true
73067
false
false
true
true
false