Integration Guide
Connecting Meta Ads
A step-by-step guide to generating a System User Token and syncing your Facebook & Instagram campaign data.
What you'll need
Ad Account ID
Found in the URL of Ads Manager (act_...).
System User Token
Generated via Business Settings > System Users.
1
Get Ad Account ID
Go to Meta Ads Manager .
Select the correct ad account from the dropdown. Look at your browser URL:
https://adsmanager.facebook.com/.../campaigns?act=123456789
The number after act= is your Ad Account ID.
2
Create System User
Meta requires a "System User" (not a real person) to securely access API data.
1. Add User
- Go to Business Settings > Users > System Users.
- Click Add.
- Name: "SpendSignal Connect".
- Role: Admin.
2. Assign Assets
- Click Add Assets on the new user.
- Select Ad Accounts > [Your Account].
- Toggle Full Control (Manage Ad Account).
- Save Changes.
3
Generate Token
With the System User selected, click Generate New Token. Select your deployed app (if prompted).
Important: Permissions
You MUST select the following permissions from the list:
- ads_read
- read_insights
Click Generate Token and copy the long string starting with EAA....