New in Weld: Authenticate Facebook Ads with System User Tokens

If you’re managing ads across multiple accounts using Meta Business Manager, this update is for you. You can now connect Facebook Ads to Weld using secure System User access tokens, instead of relying on personal OAuth accounts.

This new option simplifies agency authentication, boosts stability, and avoids shared login credentials.

What’s changed?

In the Facebook Ads connector settings, under Authentication Method, you’ll now see two options:

OAuth (Most users)
System User (Agency)

By selecting System User (Agency), you can paste in a System User access token created via Meta Business Manager for a more scalable and secure setup.

When to use System User tokens

Use this authentication method when:

You manage multiple ad accounts across clients
You want to avoid personal login-based OAuth
You prefer stable connections that don't break when team members leave
You operate across several business entities under one parent account

🔐 How to set it up

Open Meta Business Manager:

Go to Business Settings → Users → System Users. Create or select a system user with the appropriate role.
Assign access:

Grant the system user admin or advertiser-level access to relevant ad accounts and the Facebook app .
Generate a token:

Within the System User settings, click "Generate New Token", choose your app, and select required scopes (usually ads_read / ads_management).
In Weld:
- Add data source
  
  Go to the Sources tab in Weld and click Add data source.
- Choose Facebook Ads
  
  Select Facebook Ads from the list of available connectors.
- Name your connection
  
  Enter a clear name to help identify the connection later (e.g. "facebook_ads_agency_client1").
- Select Authentication Method
  
  Choose System User (Agency).
- Paste your access token
  
  Add the System User access token you generated in Facebook Business Manager.
- Save and sync
  
  Once configured, save your setup and Weld will begin syncing data as usual.

What happens next?

Your Facebook Ads data syncs as usual, no further changes needed in your workflows.

This method supports everything from batch analysis to reverse ETL use cases, and it avoids disruptions linked to OAuth token expiry or user account changes.