ghl_ad_li_lead_form_list
Retrieve LinkedIn lead generation forms for an ad account, with optional field projection and pagination to fetch specific form data or page through full result sets.
Instructions
Get lead forms
Retrieve LinkedIn lead gen forms for an ad account. By default each form is returned in full as a plain array; pass projection (comma-separated, dot-notation for nested fields) to return only the requested fields — any value outside the known field set is rejected. When limit is provided (max 100) the response is a paginated { leadForms, paging } envelope; pass pageToken (from paging.next) to fetch the next batch. Deprecated: use GET /ad-publishing/linkedin/accounts/{accountId}/forms with header version: v4.
Endpoint: GET /ad-publishing/linkedin/{accountId}/forms (Version header: v3; source: v3/ad-publishing-v3.json)
OAuth scopes: adPublishing.readonly
Pagination params: limit — pass them to page through full result sets.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"accountId": "<accountId>",
"locationId": "<locationId>"
},
"name": "ghl_ad_li_lead_form_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Page size for a paginated fetch (max 100). When set, the response is a { leadForms, paging } envelope instead of a plain array. | |
| accountId | Yes | Account identifier | |
| pageToken | No | Opaque cursor for the next batch, taken from the previous response paging.next | |
| locationId | Yes | Location identifier | |
| projection | No | Fields to return on each lead form, comma-separated (e.g. ?projection=id,name,state,created,reviewInfo.reviewStatus). When set, only the requested fields are returned; any value outside the known field set is rejected. Nested fields use dot-notation (naming a parent like `reviewInfo` returns the whole object). Omit to receive the full form (including content.questions) as-is. |