> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Lead Forms

> Lists Snapchat lead generation forms with questions, privacy and consent details

Lists Snapchat lead generation forms with questions, privacy and consent details. Supports name, title and ID filters. Use Retrieve Leads for submitted answers.

| | |
| - | - |
| **App** | Snapchat Ads |
| **Operation ID** | `snapchat_ads_list_lead_forms` |
| **Type** | Action |
| **Connection** | `snapchat_ads` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `account` | DynamicAccount | Yes | - | Snapchat advertiser account whose lead forms should be listed. |
| `filters` | array of FilterItem | No | - | Optional filters on id, name or title, combined with AND. Use REGEXP\_MATCH or IN\_LIST for alternatives. |
| `limit` | integer | No | `100` | Maximum forms returned after filtering. Default 100. |

### FilterItem

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `field` | string or SelectableOption | Yes | - | The field to filter on, must be one of the current selected metrics or dimensions. |
| `operator` | string | Yes | - | The operator to use for filtering. Must be one of the supported values. Use REGEXP\_MATCH to search/filter by multiple OR values like '.*(summer\|holiday).*' |
| `value` | string | Yes | - | The value to filter by, always as a string: text, a number, or a regex. For IN\_LIST and NOT\_IN\_LIST, pass the values as one comma-separated string such as 'a,b,c', not as an array. For regex values, escape backslashes once in the JSON string: write \b for a word boundary, not \b. |

### SelectableOption

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `value` | string | Yes | - | |
| `label` | string | Yes | - | |

## Output

**Type**: `List[Dict]`

Raw lead\_generation\_form objects, including id, name, title, form\_fields, legal\_disclosures and available metadata.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.