> ## 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.

# Create Test Lead

> Creates a test lead on an existing Meta Instant Form to test lead routing and CRM integrations

Creates a test lead on an existing Meta Instant Form to test lead routing and CRM integrations. Can trigger connected lead automations. Requires access to the owning Page. A created lead ID confirms submission, not delivery to the CRM.

| | |
| - | - |
| **App** | Meta Ads |
| **Operation ID** | `meta_create_test_lead` |
| **Type** | Action |
| **Connection** | `meta_ads` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |
| **Requires approval** | Yes (write operation) |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `page` | string or SelectItem | Yes | - | Facebook Page that owns the Instant Form. |
| `form_id` | string | Yes | - | Existing Instant Form ID, available from meta\_list\_lead\_forms. |
| `field_data` | array of object or string | No | - | Optional test answers as Meta's native field\_data array or a JSON string. Use field names from the form's questions. Omit to use Meta's default test data. Example: \[\{"name": "email", "values": \["[test@example.com](mailto:test@example.com)"]}]. |
| `custom_disclaimer_responses` | array of object or string | No | - | Optional consent responses as Meta's native custom\_disclaimer\_responses array of objects or a JSON string, matching the form's custom disclaimers. Objects are passed through unchanged for Meta to validate. |

### SelectItem

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `value` | string | Yes | - | The value of the selectable item. |
| `label` | string | Yes | - | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |

## Output

**Type**: `Dict`

Returns Meta's created test lead object, including its id. CRM delivery must be checked separately.

**Fields**: `id`


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