Set up your own
LinkedIn Marketing app.
This guide walks you through creating a LinkedIn app and getting it approved for the Marketing Developer Platform — the gated product LinkedIn requires before you can pull ads data. Plan on ~12 minutes of clicking, plus a 1–2 week review by LinkedIn’s developer team. There’s no shortcut around the review — LinkedIn will refuse to issue tokens until the product is approved.
- · You already have a LinkedIn app with Marketing Developer Platform approved
- · You’re a B2B agency that needs branded consent for client onboarding
- · You have legal requirements to isolate LinkedIn data to a dedicated app
- · You manage many LinkedIn ad accounts and want your own rate-limit budget
- · You can’t wait 1–2 weeks for LinkedIn’s review
- · You don’t already have Marketing Developer Platform access
- · You’re only managing one or two LinkedIn ad accounts
- · You want to be reporting on LinkedIn spend by tomorrow morning
Before you begin
- A LinkedIn Developer account at linkedin.com/developers, signed in with your work LinkedIn profile.
- Admin on the LinkedIn Company Page that owns your ad accounts — LinkedIn requires every developer app to be attached to a Company Page you control.
- Willingness to apply for Marketing Developer Platform access. This is a separate, gated product — standard LinkedIn API access does not include ads. Review takes 1–2 weeks.
- Your VelaReach workspace already created and you’re logged in as an admin.
Create a LinkedIn developer app
Sign in to linkedin.com/developers/apps and click Create app. LinkedIn will ask for an app name, a Company Page to attach the app to, and a logo. Name it something recognisable like VelaReach-YourCompanyName.
LinkedIn requires a Company Page you administer — personal pages won’t work.
Request Marketing Developer Platform access
This is the real gate, and the slowest part of LinkedIn BYO setup. Inside your new app, click the Products tab. You’ll see a long list of LinkedIn API products. Find Marketing Developer Platform and click Request access.
LinkedIn will open a short application form: company info, intended use case (“Connecting our LinkedIn Ads accounts to VelaReach for reporting and automation” works fine), and the volume of API calls you expect.
Marketing Developer Platform is gated — only this product unlocks ads scopes.
Wait for the approval email, then add the product
LinkedIn will email the address on your developer account when the review is done. Don’t skip this step: approval grants you eligibility, but you still have to come back and click Add product on the Marketing Developer Platform tile. Once added, the ads scopes appear in your app’s Auth tab.
Add the VelaReach redirect URL
This is the most common thing to get wrong, so copy carefully. Open the Auth tab in your app. Scroll to the OAuth 2.0 settings section and click the pencil icon next to Authorized redirect URLs for your app. Paste this exact URL:
LinkedIn matches the redirect URL character-for-character. No trailing slash.
Copy your Client ID and Client Secret
On the same Auth tab, scroll to Application credentials at the top. You’ll see Client ID and Client Secret. Click the eye icon to reveal the secret.
Client ID is short and lowercase. Secret is longer and mixed-case.
Verify the scopes are listed
Before you leave the LinkedIn portal, double-check the OAuth 2.0 scopes on your app. You should see all four of these:
- · r_ads — read campaign and creative metadata
- · r_ads_reporting — pull spend and performance metrics
- · rw_ads — create and update campaigns (for automation rules)
- · r_organization_social — read company page metadata
If any of these are missing, the Marketing Developer Platform product hasn’t been properly added to your app. Go back to the Products tab and click Add product on Marketing Developer Platform.
Paste credentials into VelaReach
Back in VelaReach: Settings → Integrations → click the LinkedIn Ads card → Manage → Advanced tab → Set up BYO app. The 4-step wizard opens. Click past Intro and Guide, then on Step 3 paste the Client ID and Client Secret from the previous step.
Click Test & save. VelaReach makes a live call to LinkedIn’s API with your credentials and runs 5 validation checks inline.
Verify the live test passes and reconnect
You should see green check marks next to:
- · Credentials format — Client ID and Secret look well-formed
- · Redirect URL whitelisted — matches your LinkedIn app settings
- · App exists on platform — LinkedIn returned your app’s name
- · Marketing Developer Platform attached — all 4 scopes available
Click Reconnect now → to run the OAuth flow through your new app. The LinkedIn consent screen will display your app name and the scopes it’s requesting.
After reconnecting, what changes?
- · All historical spend, impressions, and ROAS data
- · Your picker selection (which ad accounts are tracked)
- · Automation rules and budget pacing configs
- · Scheduled reports and Slack notifications
- · Every tag, filter, and saved view
- · OAuth tokens revoked and re-minted via your app
- · Card shows violet BYO app pill
- · Consent screen on future reconnects displays your app name
- · Audit log records who switched and when
- · API calls count against your app’s rate limits