Set up your own
Meta Business app.

Create a Meta Business app

Sign in to developers.facebook.com. In the top-right menu click My Apps → Create App. When Meta asks to choose an app type, select Business. Name it something recognisable like VelaReach-YourCompanyName. Attach it to your Business Manager.

The "Business" app type unlocks the Marketing API that VelaReach uses.

Add the Marketing API product

Inside the app dashboard’s left sidebar, click Add Products. Scroll down until you find Marketing API and click Set up. This unlocks the scopes VelaReach will request: ads_management, ads_read, business_management.

Marketing API is the product you want — not "Facebook Login for Business" or "Instagram Basic Display".

Whitelist the VelaReach redirect URL

This is the most common thing to get wrong, so copy carefully. In the left sidebar, find Facebook Login → Settings (you may need to add the Facebook Login product first if it isn’t already listed). Scroll to Valid OAuth Redirect URIs and paste this exact URL:

The redirect URL must match character-for-character. No trailing slash.

Copy your App ID and App Secret

Click Settings → Basic in the left sidebar.

App ID is safe to copy anywhere. The App Secret is sensitive — never paste it in Slack or email.

Paste credentials into VelaReach

Back in VelaReach: Settings → Integrations → click the Meta 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 App ID and App Secret from the previous step.

Click Test & save. VelaReach makes a live call to Meta’s Graph API with your credentials and runs 5 validation checks inline.

Verify the live test passes

You should see green check marks next to:

• · Credentials format — App ID and secret look well-formed
• · Redirect URL whitelisted — matches Meta’s settings
• · App exists on platform — Meta returned your app’s name and status

You’ll likely see one amber warning about scope_sufficient — that’s expected because Meta can’t confirm Advanced Access until after your first real user OAuth. Amber is fine; only red means a real problem (see Troubleshooting below).

Click Reconnect now → to run the OAuth flow through your new app. The consent screen will show your app name.

Optional — submit for App Review

Your app works in Development Mode for people listed as developers on the app. To use it for your whole team or clients, submit for review:

• · Click App Review in the left sidebar
• · Under Permissions and Features, request ads_management, ads_read, business_management
• · Upload a 30–60 second screencast showing VelaReach’s OAuth flow
• · Submit. Approval takes 1–3 business days.