Skip to main content

​
LinkedIn Ads

In one line: Connect LinkedIn Ads so your UnleashX agent can manage ad accounts, campaign groups, and campaigns, send conversion events, and pull analytics and reports — all in plain language.

​
1. Overview

LinkedIn Ads is LinkedIn’s advertising platform for the LinkedIn Marketing API. It organizes paid activity into ad accounts, campaign groups, and campaigns, and layers on conversion tracking, lead-gen forms, and analytics that measure how each campaign performs. Once connected to UnleashX, your agent can list the ad accounts you can access, browse campaign groups and campaigns, create and update campaigns, send conversion events, query campaign analytics, and generate performance reports. It works against your live LinkedIn advertiser account using your own LinkedIn sign-in, so it respects your role and access. Connecting LinkedIn Ads to UnleashX means you can manage paid activity and read results as you talk. Instead of opening Campaign Manager to launch a campaign or pull a report, you tell your agent and it makes the change or returns the numbers — cutting the clicks while keeping your account accurate.

​
2. What you’ll need

  • A LinkedIn Ads (advertiser) account with at least one ad account you can manage.
  • LinkedIn Marketing Developer Platform access (advertiser access approved for the app used to authorize).
  • A user role with permission to create and edit campaigns and read reporting on the ad account.
  • Your account currency in mind — budgets and bids are set in the ad account’s currency.
  • An UnleashX account with access to Data Connectors.
No API key to paste. LinkedIn Ads uses OAuth — you click Authorize and sign in with LinkedIn.
LinkedIn enforces your advertiser role and Marketing API access. If your LinkedIn user can’t manage campaigns on the ad account — or the app lacks advertiser access — the agent can’t either. Budgets and bids are set in the ad account’s currency, so make sure you’re using the right account before creating campaigns.

​
3. Get your credentials

There’s no key to copy. Authentication runs through LinkedIn’s secure OAuth sign-in.
1

Start the connection in UnleashX

Connecting LinkedIn Ads (Section 4) opens a LinkedIn Allow access window.
2

Sign in with LinkedIn

Sign in with the LinkedIn account that has advertiser access to your ad account. Complete two-factor authentication if prompted.
3

Review and accept the access

LinkedIn shows the access UnleashX is requesting (see the scopes table). Click Allow.
4

Confirm your ad account

If you can access several ad accounts, pick the one you want the agent to work with. UnleashX uses its ad account ID on every request.
5

Return to UnleashX

LinkedIn redirects you back automatically and the connector links to your advertiser account. UnleashX handles the OAuth token for you — you never paste or store it yourself.
Permissions (LinkedIn OAuth scopes) UnleashX requests:
LinkedIn enforces the limits, not UnleashX. UnleashX requests only the access these tools need, and your LinkedIn advertiser role still governs what you can do on each ad account.

​
4. Connect on UnleashX

1

Open your agent

Go to https://www.tryunleashx.com and open the agent you want to connect.
2

Open Data Connectors

Inside the agent, go to Data Connectors.
3

Find LinkedIn Ads

Locate LinkedIn Ads and click Connect (or Add / Configure).
4

Authorize with LinkedIn

Click Authorize, sign in with LinkedIn, accept the access, and pick your ad account.
5

Confirm success

You return to UnleashX and the LinkedIn Ads connector shows a Connected badge.

​
Use LinkedIn Ads in a Workflow

Once connected, you can add LinkedIn Ads to any automation from the Workflows builder. Its triggers and tools appear in the Apps panel, marked with an MCP badge.
1

Add a trigger node

Open Workflows → New Workflow. On the canvas, click + Add Trigger. In the Paths panel, open the Apps tab and select LinkedIn Ads — its Triggers are listed underneath. Use the search box if you have many connectors.
2

Add an action node

Click the + below any node to add a step, then pick LinkedIn Ads again — this time the panel lists its Actions.
3

Configure the step

Fill in the fields for the trigger or action you picked. Required fields are marked with a red asterisk (*).
4

Add or select your account

Under Selected account, choose an already-connected account, or click Add Account to connect one now.
5

Save and test

Click Save. Use Test to verify the step, then toggle Publish when the workflow is ready.
The steps are the same for every connector. For the full workflow builder guide, see Using MCP in Workflows.

​
5. Available tools

​
Available triggers

​
6. Example usage

“Create a new campaign in our ‘Q3 Demand Gen’ campaign group and set its daily budget.” → Runs List Campaign Groups to find the group, then Create Campaign in it with the budget set in the ad account’s currency. “How did last month’s campaigns perform? Give me impressions, clicks, and spend.” → Runs Create Report (or Query Analytics Finder Campaign Sample) for the date range and returns the metrics.

​
7. Permissions & data access

UnleashX can:
  • List ad accounts, campaign groups, and campaigns, and get individual campaigns.
  • Create and update campaigns.
  • Send conversion events and pull analytics and performance reports.
  • Delete campaigns where your role allows (this tool is clearly marked ⚠️).
UnleashX cannot:
  • Do anything your LinkedIn advertiser role doesn’t permit.
  • Act on ad accounts you can’t access, or without Marketing API advertiser access.
  • Change your LinkedIn account password or account-wide security settings.
To disconnect: In UnleashX, open Data Connectors → LinkedIn Ads → Disconnect. You can also revoke access in LinkedIn under Settings & Privacy → Data privacy → Permitted services. Disconnecting revokes access immediately.

​
8. Troubleshooting

For general MCP issues, see /mcp/integrations.

​
9. Frequently asked questions

Do I need special LinkedIn access? Yes. Managing ads through the API requires advertiser access via the LinkedIn Marketing Developer Platform. Without it, the connector can authorize but campaign and reporting calls will be denied. What currency are budgets in? Budgets and bids use the ad account’s currency. Make sure you’re working with the right ad account before creating or updating campaigns. Can the agent capture leads? It can read lead-gen form responses through the lead-gen triggers. Use On New Lead Gen Form Created and On New Event Registration Form Response to drive workflows from new forms and submissions. Is my ad data stored by UnleashX? No. UnleashX reads and writes through the LinkedIn Marketing API live per request; it doesn’t keep a copy of your campaigns or reports.

​
10. References