LinkedIn Ads
Connects to the LinkedIn Marketing (Campaign Manager) API. An agent can list campaigns and campaign groups, fetch analytics, and pause or activate campaigns.
Add to an agent node's tools array with _node_type: "tool-linkedin-ads". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
access_token | Yes (or token) | LinkedIn OAuth access token with Marketing API access. |
token | Fallback | Used if access_token is not set. |
ad_account_id | Yes | Numeric LinkedIn ad account ID, e.g. 123456789. |
{
"name": "linkedin_ads",
"_node_type": "tool-linkedin-ads",
"access_token": "{{ secret.LINKEDIN_ACCESS_TOKEN }}",
"ad_account_id": "123456789"
}
Tools
linkedin_ads_list_campaigns
List LinkedIn ad campaigns with budget, objective and status.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | No | Filter by status: ACTIVE, PAUSED, ARCHIVED, DRAFT, CANCELED (empty = ACTIVE) |
limit | number | No | Max campaigns (default 25) |
Returns: A newline-separated list of [id] name status=... type=... $budget/day lines, or "No campaigns found.".
linkedin_ads_campaign_analytics
Get LinkedIn campaign analytics: impressions, clicks, CTR, conversions, spend.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id | string | Yes | Campaign URN or numeric ID |
days | number | No | Look-back days (default 30) |
Returns: A multi-line summary with impressions, clicks, CTR, conversions and total spend over the look-back period, or "No analytics data for campaign: <id>".
linkedin_ads_list_campaign_groups
List LinkedIn campaign groups (folders organizing campaigns).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max campaign groups to return |
Returns: A newline-separated list of [id] name status=... lines.
linkedin_ads_update_campaign
Enable or pause a LinkedIn ad campaign.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id | string | Yes | Campaign numeric ID |
status | string | Yes | ACTIVE or PAUSED |
Returns: A confirmation message stating the campaign was updated to the new status.