Clarification on API Support for Lead Form Segments (Creation & Retrieval)

[Amit Tomar]

Hello Team,

I am working on audience segments, specifically Lead Form Segments. I have a few queries and observations:

1. API Support for Creating Lead Form Segments

   • Can you confirm whether creating Lead Form segments is currently supported via API?

   • If supported, could you please share the correct API request structure and valid field/operator combinations for targeting lead form asset id?

2. API Support for Retrieving Lead Form Segments & Selected Assets

   • I created a Lead Form segment manually in the UI (selecting specific lead form assets).

   • When retrieving it via API (user_list resource), I can see the general segment data (name, description, membership details, type, etc.) but the rule_based_user_list.flexible_rule_user_list structure contains:

     { "rule_items": [ { "name": "__asset_id", "number_rule_item": { "operator": "UNKNOWN" } } ] }

     • I do not see the specific asset IDs I selected in the UI.

   • Is the API expected to return the actual selected asset IDs for Lead Form segments? If so, which field should be used to retrieve them?

3. Mismatch Between UI and API Output

   • The same Lead Form segment appears in the UI with its selected assets listed, but the API response omits them or uses "operator": "UNKNOWN".

   • Could you confirm whether this is a limitation of the current API or a bug?

Expected Outcome:

• Confirmation on whether Lead Form segments can be created via API.

• Confirmation on whether asset selections for a Lead Form segment can be retrieved via API.

• Guidance or sample API requests if both are supported.

Thanks & Regards,
Amit Tomar

[Google Ads API Forum Advisor]

Hi,

Thank you for reaching out to the Google Ads API support team.

Please find the below answers for your queries

1. To assist you further, could you please provide an uncropped UI screenshot by displaying the Google Ads customer ID while creating the lead form segments manually through the Google Ads UI.
2. Please note that the UserListRuleItemInfo method uses the string for the name field, which represents the rule variable name, not the asset ID. This name must match the corresponding key name fired by the pixel. Kindly use the below GAQL query to retrieve the lead form asset data from asset resource through the Google Ads API.

SELECT asset.lead_form_asset.business_name, asset.lead_form_asset.description, asset.lead_form_asset.fields, asset.lead_form_asset.headline, asset.lead_form_asset.privacy_policy_url, asset.lead_form_asset.delivery_methods, asset.lead_form_asset.custom_question_fields, asset.id FROM asset WHERE asset.type = 'LEAD_FORM'

You can use the search or searchStream methods in making the API calls while retrieving the data. Additionally, you can utilize the Google Ads Query Builder and Query Validator to build and validate the queries for retrieving the data from the Google Ads API.

3. To assist you further on this, please provide us with complete API logs (request and response with request-id and request header) generated at your end.

If you are using a client library and haven't enabled the logging yet, I would request you to enable logging for the specific client library that you are using. You can refer to the guides Java, .Net, PHP, Python, Ruby or Perl to enable logging at your end. For REST interface requests, you can enable logging via the curl command by using the -i flag.

You can send the details via Reply privately to the author option, or direct private reply to this email.

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               
[2025-08-11 21:40:09Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01syhMP:ref" (ADR-00329552)

[Amit Tomar]

Hi team,

I have shared the requested uncropped screenshot and logs by clicking "Reply to author" for your review.

Can you also please confirm whether it is possible to create Lead Form Segments via the Google Ads API? If yes, please share the documentation or sample code. If not, please confirm that as well.

Thank you.

[Google Ads API Forum Advisor]

Hi,

I would like to inform you that creating a lead form segment is not possible as per the documentation of the Google Ads API. Kindly note that I will raise a request for this feature to become available in the Google Ads API. However, I cannot provide a scheduled timeline for its availability in the API. So, I would recommend you to follow our Blog Post and Release Notes for future updates.

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               

[2025-08-12 08:59:15Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01syhMP:ref" (ADR-00329552)