Skip to content

How to create a read-only Meta Ads token

Step by step in Meta Business Settings: a system user token with only ads_read, so WarpExit can show ad spend and acquisition cost without being able to change or pay for ads.

Published , 4 minute read

WarpExit reads your Meta ad spend so buyers see what growth costs: spend by month, cost per new customer and payback. To do that it needs a system user token with only ads_read. That token can see reports. It cannot create, change or pay for ads.

This takes about five minutes the first time, because Meta ties tokens to an app.

Before you start

  • You need to be an admin of the business portfolio that owns the ad account (business.facebook.com).
  • Note your ad account ID: in Ads Manager it's the number in the account menu, shown as act_ followed by digits.

1. Create an app (one time)

Meta only issues system user tokens for an app.

  1. Go to developers.facebook.com/apps and click Create app.
  2. Name it WarpExit reporting. When asked for a use case, pick Other, then app type Business.
  3. Connect it to your business portfolio when asked, and create it. You don't need to publish it or submit it for review.

2. Create a system user

  1. Open Business Settings, then Users, System users.
  2. Click Add, name it WarpExit, and give it the Employee role (not Admin).

3. Give it access

With the system user selected, click Assign assets:

  1. Apps: tick WarpExit reporting. Meta needs this so it can issue the token.
  2. Ad accounts: tick your ad account and allow only View performance. Leave Manage campaigns off.

4. Generate the token

  1. With the system user selected, click Generate new token and pick the WarpExit reporting app.
  2. Expiration: choose Never.
  3. Permissions: tick only ads_read. Don't tick ads_management or business_management; WarpExit refuses tokens that have them.
  4. Click Generate token and copy it. Meta shows it only once.

5. Paste it into WarpExit

In your room, open Revenue (or the Data tab), find Ad spend, choose Connect Meta read-only, paste the token and your act_ ad account ID, tick the confirmation and click Connect. Up to 24 months of monthly spend import in seconds and update daily.

Good to know

  • Turning it off. Disconnecting in WarpExit deletes our copy. In Business Settings you can also click Revoke tokens on the system user, or remove it.
  • Several ad accounts? Connect each one separately.
  • Currency. If your ad account bills in a different currency than Stripe, WarpExit shows spend in the ad account's currency and doesn't mix the two in cost per customer.