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.
- Go to developers.facebook.com/apps and click Create app.
- Name it
WarpExit reporting. When asked for a use case, pick Other, then app type Business. - 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
- Open Business Settings, then Users, System users.
- 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:
- Apps: tick
WarpExit reporting. Meta needs this so it can issue the token. - Ad accounts: tick your ad account and allow only View performance. Leave Manage campaigns off.
4. Generate the token
- With the system user selected, click Generate new token and pick the
WarpExit reportingapp. - Expiration: choose Never.
- Permissions: tick only
ads_read. Don't tickads_managementorbusiness_management; WarpExit refuses tokens that have them. - 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.
Keep reading
Related guides
- Reconciling Stripe payouts with bank deposits before a saleHow to match Stripe payouts to bank deposits before selling a SaaS: payout timing, what gets netted out, failed payouts, and explaining unmatched items. 6 minute read.
- What to put in a data room when selling a SaaSThe folders, files and numbers buyers expect when you sell a small SaaS, what to hold back until LOI, and how to show where every number came from. 6 minute read.
- How NDAs work when you sell a small businessA plain-language guide to NDAs in small business and SaaS sales: mutual or one-way, what they cover, non-solicits, term, and what they cannot do. 6 minute read.