Set up a webhook integration for a video campaign lead form

Lead forms for video campaigns are gradually rolling out and should be available to you in the coming months. If you'd like to use lead forms sooner, reach out to your Google Account Manager.

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 video campaign lead form to your customer relationship management (CRM). After you add a webhook integration to your lead form, you’ll receive your leads in real time.

Before you begin

To add the webhook integration to your lead form, you will need to generate a webhook URL and a 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 lead data to go directly into the CRM system. The key is used for validating the leads sent.

There are two ways to generate the webhook URL and key:

Instructions

Add a webhook integration to a new lead form

  1. Sign in to your Google Ads account.
  2. In the page menu on the left, click Campaigns.
  3. Click the plus button , then select New campaign.
  4. In the goals section, select Leads
  5. Under "Campaign type", select Video.
  6. Click Continue.
  7. While setting up your campaign, scroll to the "Lead form" section, then click Form. This opens a new window, where you’ll enter details about your lead form.
  8. Fill in the details for your lead form. Learn more about setting up your lead form.
  9. Under "Lead delivery by webhook", click the box next to "Webhook: get your collected leads in real-time (optional)".
  10. Add your Webhook URL
  11. Add your Key.
  12. Click Send test data and verify if your CRM receives the data correctly. 
  13. Click Add to campaign.

Add a webhook integration to an existing lead form

  1. Sign in to your Google Ads account.
  2. In the page menu on the left, click Settings.
  3. Click the name of the campaign that you'd like to edit.
  4. Next to "Lead form", click the drop-down arrow.
  5. To edit, click the pencil icon
  6. From the lead delivery options, click Webhook.
  7. Add your Webhook URL
  8. Add your Key.
  9. Click Send test data and verify if your CRM receives the data correctly. 
  10. Click Add to campaign.

Error states

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

  • Error state A is when people save the form without sending test data (successfully).
  • Error state B is data that is not sent.
  • Error state C is data sent without Google receiving a response.
  • Error state D is data sent, but Google receives an incorrect response (different than "HTTP 200").
  • Success state is data sent, and Google receives a correct response. 
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue