LinkedIn Ads Connection

Connects your agent to LinkedIn Marketing API for B2B paid media. Read ad accounts, campaigns, creatives, and pull analytics; pause/resume campaigns under review.

Authentication

OAuth2 bearer token with rw_ads (or r_ads_reporting for read-only).

• LINKEDIN_ADS_ACCESS_TOKEN — short-lived access token, rotated per OAuth refresh

Endpoints

Accounts & campaigns

• GET /rest/adAccounts — Ad accounts the user can access
• GET /rest/adAccounts/{id}/adCampaigns — Campaigns under an account
• GET /rest/adCampaigns/{id} — Campaign detail
• POST /rest/adCampaigns/{id} — Pause/resume (requires confirmation)

Creatives

• GET /rest/adAccounts/{id}/creatives — Creatives under an account
• GET /rest/creatives/{id} — Creative detail

Analytics

• GET /rest/adAnalytics — Spend, impressions, clicks, conversions by pivot
• GET /rest/adAnalytics?q=analytics — Reporting query (date range + metrics + dimensions)

Rules

• All requests require LinkedIn-Version: 202410 (or current monthly version) header
• Access tokens expire (60 days for refresh tokens) — refresh proactively
• Versioned API breaks monthly — pin a version, monitor deprecation notices
• Pause/resume campaigns always require human confirmation (active spend)