Prerequisites

Before setting up the integration, ensure the following profile permissions are enabled:

• Lead Management → Read, Read All, Update

• Company → Read, Read All, Note

• Contact → Read, Read All, Update

• Pipeline → Read, Read All

• User → Read

Additionally:

• You must have access to a Kylas Tenant Account with API access.

• You must have access to Google Ads Lead Form Extensions.

Table of Contents

1. Introduction

2. Prerequisites

3. Step-by-Step Setup

   • Enter Kylas API Key

   • Create Webhook URL

   • Field Mapping

   • Google Ads Webhook Setup

   • Sync Logs

4. Key Notes

5. Conclusion

Step-by-Step Setup

 1. Enter Kylas API Key

• Go to the Google Ads Lead Integration App.

• Navigate to the “API Keys” section.

• Enter your Kylas API Key (you can generate this key from your Kylas account under Developer Settings → API Keys).
  

2. Create Webhook URL

• Navigate to the Webhooks section.

• Click “New Webhook”.

• Enter a Webhook Name.

• Toggle the Status ON to activate it.

• Click Save.

➡️ A Webhook URL will be generated. You will be redirected to the “All Webhooks” listing page.

• 3. Map Fields

  To ensure data from Google Ads forms is accurately stored in Kylas:

  • Click “Map Fields” in the integration app.

  • Choose the entities you want to create in Kylas:

    • Lead

    • Contact

  • Map each Google Ad form field to its corresponding Kylas field:

    • Ensure field types match (e.g., text, number).

    • You can also assign fixed fields for metadata such as:

      • Source

      • Campaign

      • Product/Service

      • Owner

      • UTM fields

  • Click Save once all mappings are completed.

  ✅ Proper mapping ensures smooth data syncing and minimizes field-type mismatch errors.





• 4. Setup Webhook in Google Ads

  Now, link the Kylas-generated webhook to your Google Ads Lead Form:

  • Copy the Webhook URL from the app.

  • Go to Google Ads → Select your Lead Form Extension.

  • Add the Webhook URL under the form’s settings.

  • Pass a test lead to verify the integration.

  • Check Kylas CRM to confirm if a Lead or Contact is created automatically.

  For reference, follow Google’s official guide on https://support.google.com/google-ads/answer/9423234?visit_id=638891153865475465-3226903038&rd=1

5. View Sync Logs

The integration app provides visibility into data syncing:

• Go to Sync Logs.

• View the list of incoming leads and their creation status in Kylas.

• If any errors occurred, the Error column will show the reason.

• Click “Details” to view raw form data received from Google Ads.

Key Notes

• Ensure field type compatibility when mapping (e.g., don’t map a number field to a text field).

• Multiple forms can be connected by generating unique webhooks for each.

• Kylas workflows can be configured post-lead creation for automation.

• Only forms with webhook capabilities (Lead Form Extensions) are supported.