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

# Update Lead Form

> Low-level LinkedIn Lead Gen Form update

Low-level LinkedIn Lead Gen Form update. Forwards a native leadForms partial-update body unchanged. Supports editing draft forms and limited edits to published forms, including archiving (PUBLISHED to ARCHIVED). LinkedIn validates editable fields and state transitions. Archiving stops associated ads from serving; changing questions may require CRM field remapping. Requires rw\_ads, not Lead Sync access.

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

## Inputs

| Field            | Type                 | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ---------------- | -------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`        | DynamicAccount       | Yes      | -       | Select the LinkedIn Ads account that owns the lead form.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `lead_form`      | string or SelectItem | Yes      | -       | Form ID or urn:li:adForm:123 from linkedin\_ads\_list\_lead\_forms. The ID goes in the request path, not in update\_payload.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `update_payload` | object or string     | Yes      | -       | Raw LinkedIn leadForms partial-update body, forwarded unchanged. Accepts a JSON object or JSON string. Archive example: \{"patch":\{"\$set":\{"state":"ARCHIVED"}}}. Use the form's locale for localized text. Draft/unattached forms, or forms linked only to draft campaigns, allow edits to all editable fields. Published forms allow limited edits to headline, description, legal disclaimer, privacy/landing URLs, thank-you message/CTA and status; published forms linked to Sponsored InMail or Conversation Ads cannot be edited. LinkedIn documents PUBLISHED to ARCHIVED; do not assume other state transitions are supported. Archiving stops associated ads from serving. Changing questions may require remapping fields in a connected CRM. LinkedIn validates the payload. |
| `dry_run`        | boolean              | No       | `False` | When true, return the resolved update body without calling LinkedIn. This does not validate it against LinkedIn's API.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |

### 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 the form ID, forwarded payload and dry\_run flag. LinkedIn's response is included when nonempty; successful updates normally return HTTP 204 with no body.

**Fields**: `lead_form`, `payload`, `dry_run`, `response`