Back to Help

Connect Meta Ads (Facebook & Instagram)

Let your AI employee read campaign performance and create or adjust ads across Facebook and Instagram using your Meta Business account.

Meta Business Settings

Why a System User token (not your login)

Personal access tokens are tied to one human and expire frequently, which would break automated campaigns the moment you change your password or your session lapses.

A System User is a non-human account inside your Business Manager built exactly for app-to-app automation. Its token is long-lived and scoped to only the permissions you grant — so the AI employee can run ads without acting as you.

We store the token as an encrypted secret and proxy ad API calls through our backend, so the raw token is never exposed inside the workroom container.

Where to get your token & IDs

  1. 1Open Meta Business Manager → Business Settings.
  2. 2Under Users → System Users, create (or pick) a System User and click "Generate new token".
  3. 3Select your app and grant the ads_management, ads_read, and business_management permissions.
  4. 4Copy the token immediately — it is shown only once. This is your META_ACCESS_TOKEN.
  5. 5Find your Ad Account ID under Accounts → Ad Accounts (the numeric part, without the "act_" prefix).
  6. 6Find your Pixel ID in Events Manager → Data Sources → Pixels if you want conversion tracking.

Access token

The access token is the single credential that authorises every Marketing API call. Keep it secret — anyone with it can spend your ad budget. Revoke it any time by removing the System User token in Business Settings.

Ad Account & Pixel IDs

The Ad Account ID tells the API which account to bill and report on. The Pixel ID links conversions on your website back to the ads that drove them, so the AI employee can optimise for real outcomes rather than clicks.

Help & Knowledge Base