Power BI Connector for LinkedIn Marketing Solutions

Build 25.0.9454

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.

Copyright (c) 2025 CData Software, Inc. - All rights reserved.
Build 25.0.9454