Meta Ads

Facebook Marketing (Meta Ads) (Client-Owned Ad Account)

This guide explains how a client can grant read-only (Analyst) access to Connecty so we can sync Facebook Marketing data into Connecty's managed data warehouse (default: Google Bigquery, transfer via Airbyte).

Overview

We connect to the client’s Meta Ad Account using OAuth with the Connecty service email:

• Connecty login email: [e-mail]

• Required access level: Analyst (Ad Account role)

Analyst is sufficient for pulling campaigns / ad sets / ads / insights and follows least-privilege access.

Prerequisites (Client)

Client must have:

• A Meta Business Manager with the Ad Account

• A user with Admin access to the Ad Account (to grant roles)

• The Ad Account ID(s) they want synced

Step 1 — Client grants Analyst access to Connecty

Client should do the following in Meta Business Settings:

1. Open Business Settings

2. Go to Accounts → Ad accounts

3. Select the correct Ad Account

4. Go to People (or Users/People depending on UI)

5. Click Add people

6. Enter: [e-mail]

7. Assign role: Analyst

8. Click Invite / Confirm

✅ Expected result: [e-mail] appears on the Ad Account with Analyst role.

Note: This access must be granted on the Ad Account, not just the Business Manager.

Step 2 — Client shares the Ad Account ID(s)

Client provides the Ad Account ID(s) to Connecty.

How to find it:

• In Meta Ads Manager, the Ad Account ID is shown in the account dropdown

• Or in the URL (often like act_1234567890)

We support multiple accounts: provide comma-separated IDs.

Example:

• 1234567890

• 1234567890, 9876543210

Email it to [e-mail].

That's it from your end!

Validation Checklist

After setup, Conneecty support team will confirm:

• Source test passes in Airbyte

• Streams list populates (campaigns, adsets, ads, insights)

• First sync completes successfully