LinkedIn Marketing

LinkedIn Campaign Manager holds your highest-intent B2B signals — ad impressions by seniority, lead gen form fills with job titles, and creative performance by industry vertical. These four jobs pull that data through Mavera’s surfaces (Focus Groups, Personas, Mave Agent, Generate) so every sponsored post, lead nurture, and content brief is grounded in real campaign intelligence.

API Reference Card

Detail	Value
Base URL	`https://api.linkedin.com/rest/`
Auth	OAuth 2.0 (3-legged) — `Authorization: Bearer {token}` + `LinkedIn-Version: 202401` header
Rate limits	Daily, unpublished — varies by endpoint and app tier; throttled via `X-Li-Throttle` headers
Mavera base	`https://app.mavera.io/api/v1`
Mavera auth	`Authorization: Bearer mvra_live_...`

All examples use two environment variables: LINKEDIN_ACCESS_TOKEN and MAVERA_API_KEY. LinkedIn tokens expire — use the refresh token flow for production jobs. Never commit tokens.

Prerequisites

LinkedIn Marketing API access

Create an app at LinkedIn Developers with the Advertising API product. Request access to r_ads, r_ads_reporting, r_ads_leadgen_automation, and r_organization_social scopes.

3-legged OAuth token

Complete the Authorization Code Flow to obtain an access token. Store the refresh token for automated renewal.

Mavera API key

Get your key from Mavera dashboard.

Environment variables

export LINKEDIN_ACCESS_TOKEN="AQV..." and export MAVERA_API_KEY="mvra_live_xxxxx"

Jobs

#	Job	LinkedIn Data	Mavera Surface	Output
1	Sponsored Content → Focus Group	Creatives from ad accounts	Focus Groups + Personas	B2B persona feedback on ad relevance
2	Lead Gen → Persona Enrichment	Lead gen form responses	Persona Discovery + Custom Personas	Enriched personas by title/industry/size
3	Campaign Analytics → Content Brief	Analytics pivoted by industry/function/seniority	Mave Agent + Generate	Segment-specific content briefs
4	Ad Copy Generation	Existing ad copy + metrics	Generate + Brand Voice	New ad copy with brand voice

Rate Limits & Production Notes

LinkedIn Endpoint	Limit	Strategy
Creatives / Campaigns	Daily quota (unpublished)	Cache responses; batch requests
Ad Analytics	Daily quota	Run overnight; store results locally
Lead Gen Forms	Daily quota	Paginate with `start`/`count`; cache

LinkedIn does not publish exact rate limits for Marketing API endpoints. Monitor X-Li-Throttle-* response headers and respect Retry-After on 429s. For production, implement exponential backoff starting at the Retry-After value.

Checklist: Secure tokens in env vars or secrets manager. Implement OAuth refresh token rotation — access tokens expire after 60 days. Include LinkedIn-Version header on every call. Monitor Mavera credits at Dashboard. Cache LinkedIn data locally for daily jobs.

​API Reference Card

​Prerequisites

​Jobs

​Rate Limits & Production Notes

All Integrations