Create Lead Form - Markifact

Create a LinkedIn Lead Gen Form (ad form) in DRAFT state with prefilled or custom questions, privacy policy, consent checkboxes and a thank-you message/link/CTA. Returns the form ID and adForm URN for ad creation. Requires rw_ads; does not require Lead Sync access.


App	LinkedIn Ads
Operation ID	`linkedin_ads_create_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	-	Ad account that will own the form.
`name`	string	Yes	-	Internal form name.
`headline`	string	Yes	-	Form headline shown to members.
`description`	string	No	-	Optional introductory text.
`locale`	string	No	`en_US`	Form language and country, e.g. en_US or nl_NL. Supply labels and copy in that language.
`questions`	array of object or string	Yes	-	LinkedIn leadForms question objects, sent as-is. Accepts an array or JSON array string. Use name, question.localized, questionDetails and optional predefinedField/responseRequired. Prefill fields include EMAIL, FIRST_NAME, LAST_NAME, WORK_EMAIL and JOB_TITLE. Localized keys must match locale. Advanced fields pass through unchanged. Prefill example: [{“name”:“email”,“question”:{“localized”:{“en_US”:“Email”}},“predefinedField”:“EMAIL”,“questionDetails”:{“textQuestionDetails”:{}},“responseRequired”:true}]. Custom choice example: [{“name”:“budget”,“question”:{“localized”:{“en_US”:“Budget?”}},“questionDetails”:{“multipleChoiceQuestionDetails”:{“options”:[{“id”:1,“text”:{“localized”:{“en_US”:“Under $1,000"}}},\{"id":2,"text":\{"localized":\{"en_US":"$ 1,000 or more”}}}]}},“responseRequired”:false}]. For custom text, omit predefinedField and use textQuestionDetails.
`privacy_policy_url`	string	Yes	-	Public privacy policy URL.
`legal_disclaimer`	string	No	-	Optional privacy/disclaimer text.
`consents`	array of object or string	No	-	Optional LinkedIn consent objects, sent as-is. Accepts an array or JSON array string. Use id, consent.localized and checkRequired. Localized keys must match locale. Example: [{“id”:1,“consent”:{“localized”:{“en_US”:“Contact me by email”}},“checkRequired”:false}].
`hidden_fields`	array of object or string	No	-	Optional LinkedIn hiddenFields, sent as-is. Accepts an array or JSON array string. Example: [{“name”:“source”,“value”:“linkedin”}]. LinkedIn allows up to 20 fields.
`thank_you_message`	string	Yes	-	Message shown after submission.
`thank_you_url`	string	Yes	-	Destination of the button shown after submission.
`call_to_action`	string or SelectableOption	No	`{'value': 'LEARN_MORE', 'label': 'Learn More'}`	Thank-you button shown after form submission. Defaults to Learn More.

SelectableOption

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

Output

Type: Dict Returns the created form ID, adForm URN, name and state. Fields: id, urn, name, state