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.

You can create a webhook integration to link your video campaign lead form to your customer relationship management (CRM) so that you can directly receive your leads in real time. 

Before you begin

You’ll need to create the webhook before you can add it to your video campaign lead form. A webhook is an API that enables you to send lead data to your CRM system in real time. To set it up, you will need to add a webhook URL and a key to your lead form. You may need to do some configuration within your CRM system to generate the URL and 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. See our developer documentation for webhooks here

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