> ## Documentation Index
> Fetch the complete documentation index at: https://docs.botcadence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Ads lead forms

> Receive Google Ads lead-form submissions through a secure webhook

Google Ads lead forms send submissions to Botcadence through a webhook URL and key. This is different from OAuth integrations: Google Ads does not sign you in from the Botcadence wizard.

## Create the connection

<Steps>
  <Step title="Open Add Integration">
    In your project, select **Integrations → Add Integration**, find **Google Ads lead forms**, and select **Connect**.
  </Step>

  <Step title="Map form fields if needed">
    Optionally map the form's **Name**, **Phone**, and **Email** fields. Leave a mapping blank when your form uses the default field name.
  </Step>

  <Step title="Use test leads only during setup">
    Turn on **Accept Google test leads** only while you are verifying the webhook. Turn it off before production traffic.
  </Step>

  <Step title="Copy the credentials">
    Save the connection, then copy the generated webhook URL and key. Treat the key like a password.
  </Step>
</Steps>

## Connect the webhook to a list

Open **Outreach → Lists**, open the destination list, and select **Contact sync settings**. Attach the Google Ads lead-form connection and save. In Google Ads, paste the generated webhook URL and key into the lead-form delivery settings, then use Google's test request to verify the response.

<Check>
  After the Google test succeeds, disable **Accept Google test leads**. Submit a real test lead only when you are ready for it to enter the selected list.
</Check>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Google rejects the webhook">
    Copy the URL and key again, check for missing characters or spaces, and make sure the connection is attached to a list. Use the Google test request while test leads are enabled.
  </Accordion>

  <Accordion title="Test leads are not appearing">
    Confirm that **Accept Google test leads** is enabled during verification and that the list's Contact sync settings point to this connection.
  </Accordion>

  <Accordion title="The wrong fields are saved">
    Review the Name, Phone, and Email mappings in the integration and match them to the field names in the Google Ads form.
  </Accordion>
</AccordionGroup>