How to set up a webhook integration for a lead form

Webhooks use a unique URL to automatically sync data between apps. By linking your lead form to your customer relationship management (CRM) through a webhook, you’ll receive all leads directly in your system.

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 that sends lead data directly to your CRM through an "HTTP POST" request immediately after a form is submitted.
  • 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: Use a third-party provider to automatically sync lead data to your CRM through webhooks. The provider will generate and apply the webhook to your lead form for you, though a paid subscription may be required.

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've created your 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've edited your lead form, select Save.

Error states

After adding a webhook, you may encounter one of these 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
Google apps
Main menu
14457501857156857654
true
Search Help Center
true
true
true
true
true
true
73067
false
false
true
true
false