Connect your Meta ad account

Connect Meta by signing in on Meta’s own window, and when Meta grants more than one ad account, check only the ones Madder should use.

Takes about 1 minute

On this page

Before you start#

  • A Facebook login with access to the ad account (admin or advertiser on it).
  • A role in Madder with Connect & disconnect sources: owner or admin.

1Start the connection#

In quick setup, the Your ad account stage connects it. Later, open Settings › Sources, press Connect a source and pick Meta. Madder sends you to Meta’s sign-in and back. The access token never reaches your browser.

2Grant what Meta asks for#

Madder asks Meta for the permissions below, and Meta’s window lists each one before you agree:

ads_read
Read campaigns, ad sets, ads and their results.
ads_management
Make the changes you approve, such as creating a campaign switched off, pausing and switching on, changing a budget, and creating the pixel.
business_management
See the business portfolios your login belongs to, so the ad accounts under them can be listed.
pages_show_list
pages_read_engagement and pages_manage_ads: list the Facebook Pages you manage and run ads as the one you choose.

Granting access spends nothing.

3Choose the ad accounts#

Meta’s window lets you pick which ad accounts Madder may see. Grant only the ones you want Madder to manage. That can include your personal ad account, accounts owned by a business portfolio you belong to, and a business’s client accounts if you grant those too.

Back in Madder, when Meta granted more than one account, Madder asks which to use. In quick setup it asks “Which ad account should Madder use?” and you press the one for your first campaign. After connecting from Settings › Sources, Home asks “Which ad accounts should Madder use?” Check the ones to use and press Use selected. Either way, the rest stay connected but untouched. Settings › Sources marks them “Connected, not in use” (Home’s Sources panel calls them “Paused”), and Use this account brings one in later.

4Back in Madder#

After connecting from Settings › Sources, the toast reads “Meta connected, 2 ad accounts linked” (with your count). Each account appears in Settings › Sources with its currency and time zone. Open its card to see the Facebook Page its ads post as, or press Choose a Page. Results start syncing within minutes.

Stored by Madder#

Madder keeps a long-lived access token, encrypted (how it is protected), your Meta user id with the permissions Madder asked for, and each granted ad account’s id, name, currency and time zone. The full list is in What Madder can see in your ad account.

To disconnect it later, from Madder or on Meta’s side, see How to disconnect Madder or delete your data.

If it doesn’t work#

“Meta connect failed”
The sign-in was canceled or took longer than 10 minutes. Start again.
Fewer accounts than expected
An account without a currency or time zone on Meta is skipped. Fix it in Meta’s business settings and connect again. Madder also reads only the first page of accounts Meta returns, so a login with a very long list may not show every account yet.
An account reads “Connected, not in use”
Madder does not draft into it. Press Use this account on its card.
“no seat”
Your invitation to this workspace was taken back during the sign-in. Ask the owner.