Skip to main content
LinkedIn AdsVersion: v3New

Create lead form

POST/ad-publishing/linkedin/{accountId}/form
deprecated

This endpoint has been deprecated and may be replaced or removed in future versions of the API.

Create a new LinkedIn lead gen form for an ad account. Deprecated: use POST /ad-publishing/linkedin/accounts/{accountId}/form with header version: v4.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.write
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Path Parameters

accountIdstringrequired

Account identifier

Example:12345678

Query Parameters

locationIdstringrequired

Location identifier

Example:HChooFuiyPpVYzeJ4HMe

Body

application/json
ownerobjectrequired

Form owner

creationLocaleobjectrequired

Creation locale

namestringrequired

Form name

Example:Contact Us
statestringrequired

Form state

Available optionsPUBLISHED
Example:PUBLISHED
contentobjectrequired

Form content

hiddenFieldsobject[]

Hidden fields

Response

application/json

The created lead form. Same shape as a list entry, minus reviewInfo until LinkedIn reviews it.

idnumber

Form id. Returned as a number.

Example:1025914010
namestring

Form name

Example:Q3 demand generation form
statestring

Form lifecycle state

Example:PUBLISHED
versionIdnumber

Version of the form definition

Example:1
creatednumber

When the form was created, epoch milliseconds

Example:1787056838757
lastModifiednumber

When the form was last modified, epoch milliseconds

Example:1787057842322
creationLocaleobject

Locale the form was authored in

ownerobject

Account that owns the form

reviewInfoobject

LinkedIn review outcome. Absent on a form that has just been created and not yet reviewed; present on reads.

hiddenFieldsobject[]

Hidden fields submitted alongside the lead. Empty array when none.

contentobject

Form definition