---
title: "Google Ads lead forms"
url: https://docs.light-ai.app/inbound/google-ads.md
canonical_url: https://docs.light-ai.app/inbound/google-ads
last_updated: 2026-10-13
summary: "Connect Google Ads lead form assets directly to Light AI with a webhook URL and key. No middleware."
api_status: beta
related:
  - https://docs.light-ai.app/inbound
  - https://docs.light-ai.app/integrations/google-ads
  - https://docs.light-ai.app/api-reference/inbound/receive-google-ads-lead
---

# Google Ads lead forms

> Connect Google Ads lead form assets directly to Light AI with a webhook URL and key. No middleware.

1. In Light AI: **Settings → Developers → Inbound → New source → Google Ads lead form**. Copy the webhook URL (`https://api.light-ai.app/v1/inbound/google-ads/src_…`) and the key.
2. In Google Ads: open the lead form asset → **Lead delivery** → **Webhook integration**. Paste the URL and the key.
3. Click **Send test data**. Test leads (`is_test`) run in [test mode](https://docs.light-ai.app/test-mode) and never reach the contractor's pipeline.

## Field mapping

| Google | Light AI |
| --- | --- |
| `FULL_NAME`, `FIRST_NAME`, `LAST_NAME` | `contact.*` |
| `EMAIL`, `WORK_EMAIL` | `contact.email` |
| `PHONE_NUMBER`, `WORK_PHONE` | `contact.phone` |
| `PHONE_NUMBER_VERIFIED` | `contact.phone_verified` |
| `STREET_ADDRESS`, `CITY`, `REGION`, `POSTAL_CODE`, `COUNTRY` | `address.*` |
| `SERVICE` | `service_interest` when it matches; the text is kept |
| Other questions | `custom_fields` |
| `campaign_id`, `adgroup_id`, `creative_id`, `gcl_id`, `form_id`, `asset_group_id` | `attribution` (`gcl_id` → `gclid`) |
| `lead_id` | `external_ref` (`system: google_ads`): a resend replays the lead |

## Responses

Answers follow Google's retry rules: `200` on success, `400` for a bad key or malformed lead (Google does not retry), `503` when Google should retry (a limit or a transient error; never `429`).

> **Tip:** Keep the `gclid`: on `quote.approved` you can upload an offline conversion to Google Ads from n8n. See [Google Ads & LSA](https://docs.light-ai.app/integrations/google-ads).