LinkedIn v1 uses an access token only. Store it once in your OS credential store:
agent-ads linkedin auth setOr set a shell variable for the current process:
export LINKEDIN_ADS_ACCESS_TOKEN=access-tokenOptional default account:
export LINKEDIN_ADS_DEFAULT_ACCOUNT_ID=1234567890Add --api to also ping the LinkedIn Marketing API and confirm the token works.
agent-ads linkedin doctorAdd --api to also ping the LinkedIn Marketing API and confirm the token works.
agent-ads linkedin ad-accounts list
agent-ads linkedin ad-accounts search --status ACTIVEagent-ads linkedin campaign-groups list --account-id 1234567890
agent-ads linkedin campaigns list --account-id 1234567890
agent-ads linkedin creatives list --account-id 1234567890agent-ads linkedin analytics query \
--finder statistics \
--account-id 1234567890 \
--pivot CAMPAIGN \
--time-granularity DAILY \
--since 2026-03-01 \
--until 2026-03-16 \
--fields impressions,clicks,costInLocalCurrency1 guides — exact flags, auth details, and workflow notes.
This is the provider guide for LinkedIn Marketing API work in agent-ads.
This is the provider guide for LinkedIn Marketing API work in agent-ads.
| Task | First command |
|---|---|
| Set up auth or inspect config | agent-ads linkedin doctor |
| List accessible ad accounts | agent-ads linkedin ad-accounts list |
| Search or fetch one ad account | agent-ads linkedin ad-accounts search / get --account-id <id> |
| Explore campaign groups or campaigns | agent-ads linkedin campaign-groups list --account-id <id> / campaigns list --account-id <id> |
| Inspect creatives | agent-ads linkedin creatives list --account-id <id> |
| Run reporting | agent-ads linkedin analytics query --finder ... --account-id <id> ... |
LinkedIn v1 uses one credential:
| Credential | Persistent storage | Shell override |
|---|---|---|
| Access token | agent-ads linkedin auth set | LINKEDIN_ADS_ACCESS_TOKEN |
Optional defaults:
| Variable / config | Purpose |
|---|---|
LINKEDIN_ADS_DEFAULT_ACCOUNT_ID / providers.linkedin.default_account_id | Default ad account for scoped commands |
LINKEDIN_ADS_API_VERSION / providers.linkedin.api_version | Override the Linkedin-Version header (default 202603) |
ad-accounts list discovers accessible accounts through the authenticated-user account-access surface and adds authenticated_user_role to each hydrated account object.ad-accounts search stays account-native and returns raw LinkedIn account search results without role enrichment.campaign-groups list, campaigns list|get, and creatives list|get stay provider-native and map directly to LinkedIn Marketing API resources.analytics query wraps LinkedIn adAnalytics finder queries.insights query.--account-id, --campaign-group-id, and --campaign-id accept either raw numeric IDs or full URNs.--creative-id accepts a numeric ID or a sponsored creative URN and is normalized to a URN internally.LinkedIn list commands use cursor pagination:
| Flag | Meaning |
|---|---|
--page-token <token> | Resume from metadata.nextPageToken |
--page-size <n> | Items per API request |
--all | Follow all pages |
--max-items <n> | Stop after N items |
LinkedIn report queries use offset pagination:
| Flag | Meaning |
|---|---|
--start <n> | Start offset for the first report page |
--page-size <n> / --count <n> | Rows per API request |
--all | Follow all report pages |
--max-items <n> | Stop after N report rows |
--finder analytics: exactly one --pivot, requires --time-granularity--finder statistics: one to three --pivot values, requires --time-granularity--finder attributed-revenue-metrics: one to three pivots, only ACCOUNT, CAMPAIGN_GROUP, CAMPAIGN, requires both --since and --until, 30-366 day range, within the last year--account-id on scoped commands without setting a default--creative-id to --finder attributed-revenue-metricsagent-ads is read-only