Forms
Retrieves forms owned by a specific account, including metadata and configuration details for LinkedIn Lead Gen Forms.
Table Specific Information
To use this view, the Account column must be specified in the criteria.Select
For the Account column, the = operator is fully supported server-side. The IN operator is partially supported server-side and partially client-side. For example:
SELECT * FROM Forms WHERE Account = '512859024';
SELECT * FROM Forms WHERE Account IN ('512859024', '513009855');
When no criteria is specified, such as in this example:
SELECT * FROM Forms;
... we internally post-process the query as follows:
SELECT * FROM Forms WHERE Account IN (SELECT Id FROM Accounts);
The rest of the query is processed client-side.
Insert
To create a new form, the following fields are required: Account, Headline, LandingPage, Message, Questions, Name, Country, Language, Status.
The following fields are optional: Description, PrivacyPolicy, LegalDisclaimer, HiddenFields.
INSERT INTO Forms (
Account,
Description,
Headline,
LandingPage,
LegalDisclaimer,
Name,
PrivacyPolicy,
Country,
Language,
Status,
Message,
Questions ) VALUES (
'urn:li:sponsoredAccount:512859024',
'This is a sample form used for collecting leads.',
'Join our newsletter!',
'https://example.com/thank-you',
'You agree to our terms and conditions.',
'Sample Form Name',
'https://example.com/privacy-policy',
'us',
'EN',
'ARCHIVED',
'This is a sample message.',
'[
{
\"question\": {
\"localized\": {
\"en_US\": \"First Name\"
}
},
\"name\": \"firstName\",
\"questionDetails\": {
\"textQuestionDetails\": {
}
},
\"predefinedField\": \"FIRST_NAME\"
},
{
\"question\": {
\"localized\": {
\"en_US\": \"Last Name\"
}
},
\"name\": \"lastName\",
\"questionDetails\": {
\"textQuestionDetails\": {
}
},
\"predefinedField\": \"LAST_NAME\"
}
]' );
Update
To modify an existing form, use an UPDATE statement. Note that the Id column is required in the WHERE clause.
The following columns are mutable after creation: Description, Headline, LandingPage, Message, LegalDisclaimer, Questions, Name, PrivacyPolicy, Country, Language, Status, HiddenFields.
UPDATE Forms
SET
Description = 'New campaign form description.',
Headline = 'Try our newest product!',
LandingPage = 'https://example.com/new-landing',
Message = 'Thank you for your interest! We will contact you soon.',
LegalDisclaimer = 'By submitting this form you agree to our updated policies.',
Questions = '[
{
\"question\": {
\"localized\": {
\"en_US\": \"First Name\"
}
},
\"name\": \"firstName\",
\"questionDetails\": {
\"textQuestionDetails\": {
}
},
\"predefinedField\": \"FIRST_NAME\"
},
{
\"question\": {
\"localized\": {
\"en_US\": \"Last Name\"
}
},
\"name\": \"lastName\",
\"questionDetails\": {
\"textQuestionDetails\": {
}
},
\"predefinedField\": \"LAST_NAME\"
}
]',
Name = 'June 2025 LeadGen Form',
PrivacyPolicy = 'https://example.com/privacy',
Country = 'us',
Language = 'EN',
Status = 'DRAFT'
WHERE
Id = '13420673';
Columns
| Name | Type | ReadOnly | References | Description |
| Id [KEY] | String | True |
Unique identifier assigned to the lead form. | |
| Account | String | False |
Accounts.Id |
Identifier of the advertiser account that owns the lead form. |
| Created | Timestamp | True |
Date and time when the form was initially created. | |
| LastModified | Timestamp | True |
Date and time when the form was last modified. | |
| Description | String | False |
Descriptive text explaining the purpose or content of the form, visible to both the owner and the viewer. | |
| Headline | String | False |
Headline text displayed at the top of the form, visible to both the owner and the viewer. | |
| LandingPage | String | False |
URL of the landing page where the viewer is redirected after submitting the form. | |
| Message | String | False |
Confirmation message shown to the member after the lead form is successfully submitted. | |
| LegalDisclaimer | String | False |
Advertiser-provided legal disclaimer displayed alongside the form to inform users about data use or consent. | |
| Questions | String | False |
List of questions used to collect information from the viewer. At least one question must be defined. | |
| Name | String | False |
Internal name of the form, visible only to the owner for identification and management purposes. | |
| PrivacyPolicy | String | False |
URL of the advertiser's privacy policy covering the handling of data collected through the form. | |
| Country | String | False |
Two-letter lowercase language code defined by ISO-639-1 representing the form's language setting. | |
| Language | String | False |
Two-letter uppercase country code defined by ISO 3166 representing the form's regional context. | |
| ReviewStatus | String | True |
Indicates the current review status of the lead form. The allowed values are AUTO_REJECTED, NEEDS_REVIEW, AUTO_APPROVED, PREAPPROVED, REJECTED, APPROVED, PENDING. | |
| ReviewedAt | Timestamp | True |
Date and time when the form's review status was last updated or initiated. | |
| Status | String | False |
Specifies the overall state of the lead form. Possible values are DRAFT, PUBLISHED, or ARCHIVED. | |
| VersionTag | String | True |
Indicates the version or number of times the form has been modified. | |
| HiddenFields | String | False |
Defines hidden fields used to track key form attributes, represented in JSON format for additional metadata storage. |