Interested in sharing your feedback about the Google Ads API?
Sign up to be invited to participate in user research!
WebhookDelivery
Stay organized with collections
Save and categorize content based on your preferences.
Google notifies the advertiser of leads by making HTTP calls to an endpoint they specify. The requests contain JSON matching a schema that Google publishes as part of form ads documentation.
| Fields |
advertiser_webhook_url
|
string
Webhook url specified by advertiser to send the lead.
|
google_secret
|
string
Anti-spoofing secret set by the advertiser as part of the webhook payload.
|
payload_schema_version
|
int64
The schema version that this delivery instance will use.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-25 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-25 UTC."],[[["Google delivers leads to advertisers by sending HTTP requests to a specified endpoint (webhook)."],["These requests include lead data formatted as JSON, adhering to a schema defined in Google's form ads documentation."],["Advertisers need to provide a webhook URL and a secret key for security and validation purposes."],["Google uses a schema version to manage potential updates to the lead data structure."]]],["Google informs advertisers of new leads via HTTP calls to a designated endpoint. These requests include JSON data, structured according to a published schema. Advertisers provide a `webhook_url` for lead delivery and a `google_secret` for security. The `payload_schema_version` indicates the specific schema version used for the data. This system ensures structured communication of lead information from Google to advertisers.\n"]]
