Skip to main content
Læs siden på dansk You connect LinkedIn Ads by logging in with LinkedIn and approving the Consile app for your ad accounts. The result is an access token that Consile stores encrypted per customer. Your AI never sees the token itself.
LinkedIn Ads must be bought in the portal or be included in your plan (the free edition or the Consile Studio membership), and your AI must be connected (Claude or ChatGPT). You must be able to log in with the LinkedIn user that has access to the ad accounts (Campaign Manager) you want to connect. The connection gives access to all the ad accounts that LinkedIn user has access to. Anyone on the team can connect an agreement that is not connected yet. Only an administrator can reconnect it or disconnect it. If some accounts are under another LinkedIn user, or each ad account should have its own connection, see Multiple LinkedIn logins and ad accounts.
Unlike our pure data connectors, LinkedIn Ads can both read your ad data and (behind safety barriers) create and manage campaigns. See Actions & guardrails before you start using the write functions.

​
How to connect

1

Open the connector in the portal

Open LinkedIn Ads in the portal. Click Connect now at the top of the page, or Connect next to the agreement on the Connections card. The portal calls each connection to the system an agreement. If you have not accepted Consile’s current terms yet, the dialog starts with the Terms step: check the box and click Accept and continue. The dialog then shows the three permissions Consile asks for. Click Authorise access, and you are sent to LinkedIn’s login and approval page.
2

Log in with LinkedIn

Log in with the LinkedIn user that manages your ad accounts. Choose the right user if you have several. The access follows the user you approve with, and only reaches the accounts that user has access to.
3

Approve the Consile app

LinkedIn shows what the Consile app is asking for access to. Confirm to continue. You are then sent back to the portal automatically.
The portal shows LinkedIn Ads is connected, and the agreement shows as Connected. Your AI can now read your ad data and manage campaigns under guardrails.
4

Lock the connection to one ad account (optional)

The page also shows The key reaches several companies. Choose the one this connection should be locked to, and every call keeps to it. If you want your AI to work in only one ad account on this agreement, click Choose company. Choose the account under Choose ad account, and click Lock to this company. This requires an administrator.If you do not want to lock, click Go to connector. Your AI then chooses the account per request. See Lock a connection to one company.
If something goes wrong along the way, the portal shows Connection was not completed. Click Try again to get back to the LinkedIn Ads page, and start over with Connect now or Connect.

​
What exactly am I approving?

In one approval step, Consile asks for the set of permissions (scopes) that the connector’s ad functions use:

Read + manage behind guardrails

The connector can read your ad data and manage campaigns. New campaigns and campaign groups are created as drafts (DRAFT) by default, and activation, changing a budget or bid, and archiving require your confirmation; otherwise you only get a preview.

Access per account

The approval applies to the ad accounts the chosen LinkedIn user has access to. Your AI chooses the right account per request, unless the connection is locked to one ad account.

Encrypted per customer

The token is stored encrypted with a key that applies only to your own account, and is never logged.

Your AI never sees it

Your AI is never given the token itself, only answers to your questions.

​
Write functions and guardrails

LinkedIn Ads has 64 tools: 45 for reading and 19 for writing. 42 of them can be used today; the other 22 are not available yet (see the next section). Your AI calls them for you as linkedin-ads__<tool> (for example linkedin-ads__create_campaign). The 11 tools for ad management (campaign groups, campaigns, the status of ads and conversion rules) work today and have the safety built in:
  • New items are created as drafts. New campaign groups and campaigns are created as DRAFT. They do not serve and spend no money until you ask for it. Ads (creatives) cannot be created through the connector, only paused, activated or archived.
  • Activation, budget, bids and archiving require confirmation. Activating (ACTIVE), changing a budget or bid, or archiving requires an explicit confirm: true. Without it, the tool only returns a preview of what it would do, and sends nothing to LinkedIn.
  • Some changes happen without confirmation. Name, end date and targeting can be changed right away, also on an active campaign. The same applies to creating and editing conversion rules (including switching a rule off) and to linking a conversion rule to a campaign.
On a connection that is locked to one ad account, three of the 11 are not available: update_conversion_rule, associate_campaign_conversion and remove_campaign_conversion. The same applies to five read tools: get_ad_preview, get_conversion_rule, list_campaign_conversions, get_lead_form and query. See Lock a connection to one company. LinkedIn Ads does not have the Read only level. A user with All tools under Team also gets the write tools. If a user should only read, an administrator chooses Custom and only the read tools. See Custom access. Read the whole model in Actions & guardrails.

​
Tools that are not available yet

22 of the 64 tools are not available yet. Your AI can see them, but they cannot yet fetch or change anything at LinkedIn, and your AI gets an error if it tries. This applies to:
  • the 8 write tools for organic content: posts, comments and reactions as a company page or in your own name (create_organization_post, create_member_post, update_post, delete_post, create_comment, delete_comment, create_reaction, delete_reaction)
  • 14 read tools for the Company Page, posts and your own profile (list_administered_organizations, get_organization, find_organization_by_vanity_name, get_organization_follower_count, list_organization_posts, get_organization_page_statistics, get_organization_follower_statistics, get_organization_share_statistics, get_post, get_post_social_metadata, list_post_comments, list_post_reactions, get_my_profile, get_my_connections_count)
The ad functions above work today. On a locked connection, your AI does not see 20 of the 22 tools. Only get_my_profile and get_my_connections_count are still there.

​
The access is renewed automatically

Consile renews the LinkedIn access automatically, so you normally do not have to reconnect. You must reconnect if you revoke the access yourself, or if LinkedIn refuses it for other reasons. The automatic renewal does not change a lock.
If the access has expired or been revoked, your AI gets a message that LinkedIn Ads must be reconnected. The portal can still show Connected, because access is stored.
How an administrator reconnects:
  • If the agreement says Access revoked, click Reconnect, and approve again at LinkedIn.
  • Otherwise: click the menu (the three dots) next to the agreement on the Connections card, choose Disconnect, and confirm with Disconnect. This only deletes the stored token at Consile, and the subscription continues. Then click Connect, and approve again at LinkedIn.
  • You can also ask your AI to reconnect LinkedIn Ads. The connector has the tool connect_account, which gives a link straight to LinkedIn’s approval. The link works for 10 minutes, and the new token replaces the old one. Ask in the connector that belongs to the agreement (for example linkedin-ads-2), so the link connects exactly that agreement.
If the connection is locked to one ad account, the account must be chosen again after you have reconnected. After Reconnect or a link from your AI, Consile refuses all calls on the agreement until an administrator has chosen it. If you disconnected first, the lock is gone, and your AI can reach all of the user’s ad accounts until the account has been chosen again. See After a new connection.

​
Multiple LinkedIn logins and ad accounts

One agreement covers all the ad accounts that the connected LinkedIn user has access to. There are two reasons to add another agreement:
  • Another LinkedIn user. Connect the new agreement with the other user.
  • One ad account per agreement. Connect the new agreement with the same LinkedIn user, and lock each agreement to its own ad account. Then each account has its own address in your AI, and your AI only reaches the account the agreement is locked to. An ad account can only be locked on one agreement at a time.
How to do it:
  1. On the Connections card, an administrator clicks Add agreement (199.50 kr/mo.). The agreement is added to the subscription and charged pro rata for the rest of the period.
  2. When the new agreement is ready (typically after a few seconds), click Connect next to it and log in with the LinkedIn user the agreement should use.
  3. Each agreement has its own address, for example https://mcp.consile.ai/linkedin-ads-2/mcp. Copy it from the card, and add it as a separate connector in your AI.
The agreements show as Agreement 1, Agreement 2 and so on. If an agreement is locked, Locked to <ad account> appears under the name. A user who has access to LinkedIn Ads can use all the agreements. If you connect the same LinkedIn user on two agreements without locking them, it does not give access to more, but you pay for two agreements. Under the Consile Studio membership there is no button to add an agreement. Instead the card says The membership covers this system. One more company costs full price under the membership, and we will set it up for you if you write to us. If you have more than one agreement, an administrator can remove an agreement: click the menu next to the agreement, choose Remove the agreement, and confirm with Remove agreement. If you remove, for example, Agreement 2 while there is also an Agreement 3, Agreement 3 moves up into the free slot and then uses the address https://mcp.consile.ai/linkedin-ads-2/mcp. If it was locked, the ad account must be chosen again before it answers. So check the connectors in your AI after you have removed an agreement. If only one agreement is left, you remove it by cancelling the subscription under Subscription. See Pricing.

​
Revoke access

You can remove the access again at any time:
  • In the portal: an administrator clicks the menu (the three dots) next to the agreement on the Connections card, chooses Disconnect and confirms with Disconnect. The stored token is then deleted at Consile, and any lock disappears. The subscription continues, and the access at LinkedIn is not revoked automatically. If you have several agreements, an administrator can also remove an agreement entirely with Remove the agreement. Its token is then deleted too.
  • At LinkedIn: remove the Consile app’s access under Permitted services in your LinkedIn settings. After that, the connector stops working, and you must reconnect to use it.
When you disconnect in the portal, Consile deletes the stored token right away. We keep no copy of your LinkedIn data: only the access itself, which is then removed.
More about data processing in Security & data.