LinkedIn

Warning

Please upgrade your scenarios that contain old LinkedIn modules to the current version of the LinkedIn modules. As of May 1, 2019, the old version is no longer supported and may stop working anytime.

The LinkedIn modules enable you to monitor, create and delete posts on a user's wall or create and delete posts on behalf of an organization, create, update, list, retrieve, and delete the lead gen forms, and form responses in your LinkedIn account.

Getting Started with LinkedIn

Prerequisites

Notice

The module dialog fields that are displayed in bold (in the Make scenario, not in this documentation article) are mandatory!

  1. Go to Make and open the LinkedIn module's Create a connection dialog and click Continue.

    61d6a48158379.gif
  2. Confirm the access by clicking Allow.

    61d6a483b093b.png

The connection has been established.

Triggers when a Lead Gen Form is submitted.

Required Permissions: r_ads, r_ads_leadgen_automation

This webhook is an instant trigger ideal for normal users to receive a response when a member submits a form. For more information, see Instant Triggers.Instant triggers (webhooks)

You do not have to add the webhooks in LinkedIn as it is automatically done for you once you add and save an instant trigger module to your scenario.

Webhook Name

Enter (map) a webhook name.

Connection

Establish a connection to your LinkedIn account.

Ad Account URN

Select or map the account URN whose campaign form responses you want to watch.

Triggers when a Lead Gen Form is submitted.

Required Permissions: r_ads, r_ads_leadgen_automation

This module is a general trigger to watch and trigger an alert to the user when a form response is received based on the specified filters in the module. For more information, see Webhooks.

Connection

Establish a connection to your LinkedIn account.

Ad Account URN

Select or map the account URN whose campaign form responses you want to watch.

Campaign URN

Select or map the campaign associated with the form

Creative URN

Enter (map) the Creative URN associated with the form.

Fields

Enter (map) the fields you want to watch in the form response. For more information, see Fields Projection.

Projection

Enter (map) the projections you want to watch in the form response. For more information, see Response Decoration.

Limit

Set the maximum number of form responses Make should return during one execution cycle.

Retrieves a list of Lead Gen Forms.

Required Permissions: r_ads, r_ads_leadgen_automation

Connection

Establish a connection to your LinkedIn account.

Ad Account URN

Select or map the ad account URN whose lead gen forms you want to list.

Limit

Set the maximum number of lead gen forms Make should return during one execution cycle.

Retrieves the details of a Lead Gen Form.

Required Permissions: r_ads, r_ads_leadgen_automation

Connection

Establish a connection to your LinkedIn account.

Form ID or URN

Select or map the Form ID or URN whose details you want to retrieve.

Retrieves a list of responses of a Lead Gen Form.

Required Permissions: r_ads, r_ads_leadgen_automation

Connection

Establish a connection to your LinkedIn account.

Ad Account URN

Enter a keyword or phrase to search and list the form responses that match the specified query.

Form URN

Enter (map) the Form ID or URN whose responses you want to list.

Campaign URN

Enter (map) the campaign URN to which the form belongs.

Creative URN

Enter (map) the creative URN associated with the form whose responses you want to list.

Start Time

Enter (map) the date and time to list the form responses created on or after the specified time.

End Time

Enter (map) the date and time to list the form responses created on or before the specified time.

Limit

Set the maximum number of form responses Make should return during one scenario execution cycle.

Retrieves a response of a Lead Gen Form.

Required Permissions: r_ads, r_ads_leadgen_automation

Connection

Establish a connection to your LinkedIn account.

Ad Account URN

Select or map the account URN whose form response details you want to retrieve.

Response ID or URN

Enter (map) the Response ID or URN whose details you want to retrieve.

Updates the status of a Lead Gen Form by its ID.

Required Permissions: r_ads, r_ads_leadgen_automation

Connection

Establish a connection to your LinkedIn account.

Form ID or URN

Select or map the Form ID or URN whose status you want to update.

Status

Select or map the status you want to update for the form:

  • Archived

  • Canceled

  • Paused

  • Submitted

Retrieves the details of a question of a Lead Gen Form by its ID.

Connection

Establish a connection to your LinkedIn account.

Form ID or URN

Select or map the Form ID or URN whose question details you want to retrieve.

Question ID

Enter (map) the Question ID whose details you want to retrieve.

Creates a new Lead Gen Form.

Required Permissions: rw_ads, r_ads, r_ads_leadgen_automation

Connection

Establish a connection to your LinkedIn account.

Ad Account URN

Select or map the ad account URN for which you want to create the form.

Language

Select or map the language of the form.

Name

Enter (map) the form name. The form is visible to the owner of the form but not visible to the viewer.

Headline

Enter (map) the form headline.

Privacy Policy URL

Enter (map) the privacy policy URL that covers any data passed to the owner of the form.

Lead Profile Information

Select or map the lead profiles for whom the form is targeted to.

Custom Questions

Add the questions targeted for the lead profiles.

Name

Enter (map) the question name.

Question Type

Select or map the question type:

  • Custom Text Question

  • Custom MC Question

Question

Enter (map) the question. A maximum of 100 characters is allowed.

Options

If the question is of MC type, add the options applicable for the question.

A maximum of 12 questions is allowed.

Descriptions

Enter (map) the details of the form. A maximum of 160 characters is allowed.

Legal Disclaimer

Enter (map) the disclaimer text that appears on the form. A maximum of 2000 characters is allowed.

Custom Checkboxes

Add the custom checkboxes for the form: Content

Add the content of the checkbox fields. A maximum of 500 characters is allowed. Consent Required

Select the checkbox if consent is required to display the custom checkbox.

Thank You Message

Enter (map) the message displayed to a member after the form is submitted. The maximum number of characters allowed is 300 characters.

Landing Page URL

Enter (map) the form URL address.

Thank You Message Call-to-action

Enter (map) the message displayed on the call-to-action button. You can set one of the following values:

  • LEARN_MORE

  • VIEW_NOW

  • DOWNLOAD_NOW

  • TRY_NOW

  • VISIT_COMPANY_WEBSITE (default).

Note

This message appears as text on the button. The URL is controlled by the landingUrl attribute.

Hidden Fields

Add the hidden fields for the form.

Name

Enter (map) the field name

Value

Enter (map) the field value.

Note

You can add up to 20 fields.

Updates an existing Lead Gen Form by its ID.

Required Permissions: rw_ads, r_ads, r_ads_leadgen_automation

Connection

Establish a connection to your LinkedIn account.

Form ID or URN

Select or map the Form ID or URN whose details you want to update.

Name

Enter (map) the form name. The form is visible to the owner of the form but not visible to the viewer.

Headline

Enter (map) the form headline.

Privacy Policy URL

Enter (map) the privacy policy URL that covers any data passed to the owner of the form.

Lead Profile Information

Select or map the lead profiles for whom the form is targeted to.

Custom Questions

Add the questions targeted for the lead profiles.

Name

Enter (map) the question name.

Question Type

Select or map the question type:

  • Custom Text Question

  • Custom MC Question

Question

Enter (map) the question. A maximum of 100 characters is allowed.

Options

If the question is of MC type, add the options applicable for the question.

A maximum of 12 questions is allowed.

Descriptions

Enter (map) the details of the form. A maximum of 160 characters is allowed.

Legal Disclaimer

Enter (map) the disclaimer text that appears on the form. A maximum of 2000 characters is allowed.

Custom Checkboxes

Add the custom checkboxes for the form: Content

Add the content of the checkbox fields. A maximum of 500 characters is allowed. Consent Required

Select the checkbox if consent is required to display the custom checkbox.

Thank You Message

Enter (map) the message displayed to a member after the form is submitted. The maximum number of characters allowed is 300 characters.

Landing Page URL

Enter (map) the form URL address.

Thank You Message Call-to-action

Enter (map) the message displayed on the call-to-action button. You can set one of the following values:

  • LEARN_MORE

  • VIEW_NOW

  • DOWNLOAD_NOW

  • TRY_NOW

  • VISIT_COMPANY_WEBSITE (default).

Note

This message appears as text on the button. The URL is controlled by the landingUrl attribute.

Hidden Fields

Add the hidden fields for the form.

Name

Enter (map) the field name

Value

Enter (map) the field value.

Note

You can add up to 20 fields.

Create a Text Post

Shares a simple text, article, or URL on the user's wall.

Required Permissions: w_member_social

Connection

Establish a connection to your LinkedIn account.

Content

Enter the text content of the post.

Visibility

Select whether the post will be visible to the public or to my connections only.

Type

Select whether to post simple text or link.

Link

  • URL: Enter the URL of the link you want to post.

  • Title: Enter the title for the link.

  • Description: Enter the link description.

Create an Image Post

Shares an image post on the user's wall.

Required Permissions: w_member_social

Connection

Establish a connection to your LinkedIn account.

Source File

Map the file you want to upload from the previous module (For example, HTTP > Get a File or Dropbox > Get a file), or enter the file name and file data manually.

  • Filename: Enter the file name.

  • Data: Enter or map file data manually.

Visibility

Select whether the post will be visible to the public or to my connections only.

Title

Enter the title for the image post.

Description

Enter the description for the post.

Content

Enter the text content shared with the image.

Delete a Post

Removes a post from the user's wall.

Required Permissions: w_member_social

Connection

Establish a connection to your LinkedIn account.

Post ID

Enter (map) the ID of the post you want to delete.

Create a Text Post

Shares a simple text, article, or URL on behalf of an organization.

Required Permissions: rw_organization_admin, w_organization_social

Notice

You may need to extend Make permissions for LinkedIn access.

Connection

Establish a connection to your LinkedIn account.

Organization

Select the organization you want to create a post on behalf of.

Content

Enter the text content of the post.

Type

Select whether to post simple text or link.

Link

  • URL: Enter the URL of the link you want to post.

  • Title: Enter the title for the link

  • Description: Enter the link description.

Create an Image Post

Shares an image post on behalf of an organization.

Required Permissions: rw_organization_admin, w_organization_social

Connection

Establish a connection to your LinkedIn account.

Organization

Select the organization you want to create a post on behalf of.

Source File

Map the file you want to upload from the previous module (For example, HTTP > Get a File or Dropbox > Get a file), or enter the file name and file data manually.

  • Filename: Enter the file name.

  • Data: Enter or map file data manually.

Title

Enter the title for the image post.

Description

Enter the description for the post.

Content

Enter the text content shared with the image.

Search for Organizations

Finds organizations by the vanity name or email domain.

Connection

Establish a connection to your LinkedIn account.

Find Organization By

Select the option you want to search organizations by.

  • Vanity Name: The Vanity Name is used to represent the public profile URL in the following format: www.linkedin.com/in/{vanityName}. Each LinkedIn profile has a unique vanityName.

  • Email Domain: Enter the email domain of the organization. E.g. Make.com

Limit

Set the maximum number of organizations Make will return during one execution cycle.

Make an API Call

Allows you to perform a custom API call.

Notice

Retrieving LinkedIn posts is not available at the moment.

Connection

Establish a connection to your LinkedIn account.

URL

Enter a path relative to https://api.linkedin.com/. E.g. /2/files/list_folder

Note

For the list of available endpoints, refer to the LinkedIn API Documentation.

Method

Select the HTTP method you want to use:

GET to retrieve information for an entry.

POST to create a new entry.

PUT to update/replace an existing entry.

PATCH to make a partial entry update.

DELETE to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - Create a Post

The following API call creates a user post in your LinkedIn account:

URL: /v2/ugcPosts

Method: POST

Body:

 { 
 "author": "urn:li:person:KGAMpQRO_a", 
 "visibility": { 
 "com.linkedin.ugc.MemberNetworkVisibility": "PUBLIC" 
 }, 
 "lifecycleState": "PUBLISHED", 
 "specificContent": { 
 "com.linkedin.ugc.ShareContent": { 
 "shareCommentary": { 
 "text": "test message" 
 }, 
 "shareMediaCategory": "NONE" 
 } 
 }
}
61d6a484b4e85.png

The result can be found in the module's Output under Bundle > Body.

In our example, the post ID was returned (and the post on the user's wall was created):

61d6a485d0c05.png