Connectors / Service / LinkedIn

Artisan IMG > Linkedin (linkedin)


A professional networking service with more than 600 million members


LinkedIn is a business and employment-oriented service that operates via websites and mobile apps. LinkedIn is designed to make it easier for people to network, manage their personal brand, and connect with recruiters, job seekers, and clients.

LinkedIn templates

Please note that we have the following LinkedIn templates available:

However, please continue to at least read the Authentication and Trigger setup instructions on this page to enable you to get started with using LinkedIn.



Authentication Expiration Date

Your LinkedIn account authentication will expire exactly one year after creation. The account owner will receive two warning notifications before this occurs - ten days prior to the expiration date and again five days after (should nothing have been done about this since the first warning message).

If you do not create a new LinkedIn authentication to replace your old one, within the given time frame, all workflows using the original authentication will stop working on their preassigned end date.

Permissions note

When using the adFormResponses API whoever creates the auth must also be an admin of the company's public profile page.

Otherwise you will receive a 403 "The member does not have permission to access lead"

Duplicate Authentications

If you intend to have more than one LinkedIn authentication for your account, you MUST make sure that all of your LinkedIn authentications have the EXACT SAME PARAMETERS during setup.

The structure of the and LinkedIn account partnership is such that you - as an account holder - can only have one authentication structure set up with your LinkedIn account, at any one time, when using it in conjunction with workflows.

If you do not create a new LinkedIn authentication to replace your old one, within the given time frame, all workflows using the original authentication will stop working on their preassigned end date.

When using the LinkedIn connector, the first thing you will need to do is go to your account page, select your workflow. Once in the workflow dashboard itself select and drag the LinkedIn connector from the connectors panel (on the left hand side) to your workflow.

With the new connector step highlighted, in the properties panel on the right, click on the Authenticate tab and 'Add new authentication' (located under the 'Authentication' field).


This will result in a authentication pop-up window. The first page will ask you to name your authentication, and state which type of authentication you wish to create ('Personal' or 'Organisational').

As you can see, the next page asks you to select the scopes (permissions) that you want your authentication to have. Note that we have preselected several options for you based on the most common use cases but please make sure they apply to your own project:


Version 1.0 and earlier

When selecting the parameters that you wish to use for your authentication set up, no matter which ones you decide to include, you MUST tick the first parameter:


When you've selected the scopes you want, click on the 'Add authentication' button. A pop-up window will appear, asking you to sign into your LinkedIn account:


Once you have signed in, you will then be asked to confirm that you wish to allow access to your LinkedIn account. You may have to scroll down in order to see the 'Allow' button in order to continue.


Your connector authentication setup should now be complete.

LinkedIn Trigger

If you wish your workflow to be kicked off by a particular action in LikedIn, you can use the LinkedIn Trigger.

The LinkedIn trigger allows you to receive notifications and trigger workflows when given lead gen events occur associated with the selected trigger operation.

Trigger Operations available:

  • Lead gen form webhook

Webhook Setup

When creating a new workflow, click the 'Create new workflow' button in the top right hand corner of your main dashboard. When the trigger popup window opens, search and select the LinkedIn trigger. Wait to be redirected to your new workflow and the workflow dashboard itself.


If you have already set up an authentication for the LinkedIn connector, you can use that same authentication here.

With the new LinkedIn trigger step highlighted, in the properties panel on the right, click 'Authenticate' and either select a previously created LinkedIn authentication or click on 'New Authentication' and follow the Authentication instructions above.

IMPORTANT!: Your authentication needs to have the


scope selected to be able to create lead generation form webhooks, and receive lead generation form notifications via LinkedIn.

Once authenticated, select 'Lead gen from' as the event you want your trigger to listen to (aka the operation), in order to set off the workflow itself:


WEBHOOKS: As this uses a webhook as its operation type, you will also need to integrate it with your linkedin-trigger account, in order to complete the authentication process.

To finish setting up the Lead gen form trigger, you need to select whether the relevant Account for the capmaing you wish to receive lead gen form notifications for.

In the properties panel on the right, select 'Input data' and then choose a 'Sponsored account URN' from the drop-down list.

You can also choose whether to retreive the 'Full lead data', this returns the full information associated to the lead rather than just the 'Response ID' and creation time.


Finally, once everything is setup you can enable your workflow by selecting the Enable button in the right hand corner of the workflow.

Assuming everything is setup correctly the workflow should initialize and the workflow will now trigger when relevant events occur.


Available Operations

The examples below show one or two of the available connector operations in use.

Please see the Full Operations Reference at the end of this page for details on all available operations for this connector.

Note on Operations usage

Setting up your LinkedIn account so that it can access lead generation data

Sometimes as a client you may wish to create a workflow that can handle "lead generation data". This is indeed possible, provided the following accounts and permissions are set up correctly. As a result we have decided to dedicate this section to clarifying some of the complexities often found during setup for this particular instance.


Before you can access lead generation data via the LinkedIn connector, you will first need to have the permissions set up:

Before you can access lead generation data via the LinkedIn connector, you will first need to have the following permissions set up via your LinkedIn account/s. As you may have several accounts managing different aspects of your services, please read the below diagram and information given carefully:


The first thing you need to make sure of is that you have a LinkedIn account which is capable of accessing LinkedIn's 'Campaign Manager Console'. If you are unsure if your account has these permissions please contact your LinkedIn representative for confirmation and/ or access to said console.

The console itself is where your campaigns are managed. It is with this particular LinkedIn account, and in this area of the LinkedIn application, that you are able to oversee and regulate who has access to your campaign data among other things.

You will also need to make sure that the LinkedIn account you are using in conjunction with your connector authentication, is the one you have granted campaign access rights to through said console, in order to gather your desired campaign's lead data. This LinkedIn account will also need to have been granted the role of 'Company Page Admin' as well (which again, should be handled by the console manager).

Ideally you would wish to use one LinkedIn account to manage all of the rights and roles outlined above. However in most cases this is not possible due to company and project specifications. Permissions and access management can get complex as a result, so please feel free to not only contact your LinkedIn representative but also our Customer Success Team as we are always happy to help.

All Operations

Latest version:


Get ad campaign

Return information about a campaign.

Get ad form

Get an individual Ad form using the Ad form ID.

List accounts

Return a list of accounts.

List accounts urn DDL

List ad campaign names DDL

List ad campaigns

Return a list of ad campaigns.

List ad campaigns DDL

List ad campaigns urn DDL

List ad form IDs DDL

List ad form responses

Return a list of Ad form responses.

List ad form responses DDL

List ad forms

Returns a list of Ad forms.

List ad forms urn DDL

List campaign groups

Return a list of campaign groups.

List campaign groups urn DDL

List organizations by vanity name

Returns a list of organizations matching a vanity name.

List region codes DDL

List targeting facets for options DDL

Update Ad campaign

Update an Ad campaign.

Update DMP segment

Update a DMP segment.

Get account

Retrieve a single account by ID.

Batch modify DMP segment companies

Add or remove multiple companies from a DMP Segment. Can only be used with DMP segments where type is set to Company.

Batch modify DMP segment users

Add or remove multiple users from a DMP Segment. Can only be used with DMP segments where type is set to User.

Create Ad campaign

Create an Ad campaign.

Create DMP segment

Create a DMP segment.

Find organization by email domain

Return information about an organization.

Get DMP segment

Retrieve a DMP segment by ID.

Get ad form response

Fetch a single ad form response given the account urn and lead ID.

Get current member

Get information about the currently authenticated member.

Get organization details by URN

Retrieve organization details by URN.

List account IDs DDL

List account names DDL

List account references DDL

List ad target facet options

Retrieve a list of options for values to enter for a given targeting facet and entity type e.g. if the facet is LOCATION and the entity type is COUNTRY then a list of country codes will be returned to be used in the format "urn:li:country:us".

List ad target facet types DDL

List ad targeting facets

Retrieve a list of targeting facets

List ad targeting facets DDL

List ads analytics

Returns key insights on performance (e.g. clicks, impressions, ad spend) and demographics information (e.g metrics by demographic values) at the account, campaign, and creative (sponsored content) levels.

List all forms for an ad account

List all Ad forms for an Ad account.

List campaign group IDs DDL

List creatives

Return a list of creatives for ad campaigns.

List dmp segments DDL

List form responses for ad account

Return a list of Ad form responses for an Ad account. Responses can be further filtered based on a variety of parameters such as time range, Ad form, or Campaign.

List industry codes DDL

List multiple ad form responses

Retrieve a list of multiple Ad form responses.

List multiple ad forms

Retrieve a list of multiple Ad forms by providing the Ad form IDs.