For end users

linkedin

Pull paid social performance from the LinkedIn Marketing API into the ad_metrics table.

Type: inbound. The runner calls fetch.ts directly; the model is not invoked at fetch time.

What it fetches

• Campaign-level: spend, impressions, clicks, leads.
• Campaign group / creative-level roll up under campaign.
• Daily granularity. Date range is configurable per run.

What you need

• A LinkedIn Marketing Developer Platform application. Approval-gated; see the LinkedIn integration walkthrough for the application steps. Plan two to three weeks for approval.
• An OAuth2 refresh token with r_ads_reporting scope.
• A LinkedIn Ads account the workspace runs paid through.

Configuration

• LINKEDIN_CLIENT_ID
• LINKEDIN_CLIENT_SECRET
• LINKEDIN_REFRESH_TOKEN

The CMS Apps surface (/apps/linkedin) collects these and runs a Test connection.

Where it lives

pectusai/apps/linkedin/APP.md