Skip to main content
modiva.ai
← All help articles

Connect

Meta Ads

AdsOAuthMeta Ads developer docs ↗

Meta Ads connects through the Meta Marketing API. You authorize Modiva against your ad account to plan, launch and report on Facebook and Instagram campaigns.

Before you start

  • A Meta Business account with an active ad account.
  • Admin or advertiser access to that ad account.

Step-by-step setup

  1. 1

    Sign in to Modiva

    Log in at modiva.ai and open the Dashboard. You need a Modiva account before you can connect any platform — creating one takes a minute and no credit card is required for the free tier.

    The Modiva dashboard after signing in
    The Modiva dashboard — your home for connections, posts and analytics.
  2. 2

    Open Connections → New connection

    In the left sidebar choose Connections, then click New connection. You'll see the full catalogue of platforms grouped by category (Social and Ads).

    The New connection picker listing every platform
    The connection picker. Use the search box or category filter to find your platform.
  3. 3

    Select Meta Ads

    Click the Meta Ads card. Modiva redirects you to Meta Ads's official sign-in and permission screen — your password is entered on Meta Ads, never on Modiva.

    Selecting the Meta Ads card in the connection picker
    Click Connect on the Meta Ads card to start the secure OAuth flow.
  4. 4

    Authorize Modiva on Meta Ads

    Review the permissions Modiva is requesting and approve them. If you manage more than one account, page or profile, pick the one you want Modiva to manage.

    The Meta Ads permission / consent screen
    Meta Ads's consent screen. Approve the requested scopes to continue.
  5. 5

    You're connected

    Meta Ads now sends you back to Modiva and the connection appears with a green Connected status. From here it's available to every MCP key and API call in your workspace.

    The Meta Ads connection showing a Connected status
    A healthy connection shows a green dot and the connected account name.

Permissions Modiva requests

When you connect Meta Ads, Modiva asks only for the access it needs to run the tools you use. You can revoke it any time from Meta Ads or by disconnecting in Modiva.

  • Manage your ad campaigns (ads_management)
  • Read ad performance (ads_read)

Troubleshooting & FAQ

Where is my Meta Ads password stored?

Nowhere. You sign in on the provider's own site and Modiva only receives a scoped access token, which is encrypted at rest with AES-256-GCM. Modiva never sees your password.

My connection says Expired or Error — what do I do?

Open Connections, find the platform and click Reconnect (or Refresh token). Providers periodically expire tokens or revoke them when you change your password; reconnecting re-runs the consent screen and restores access.

How do I disconnect?

Open Connections, click the Meta Ads row and choose Disconnect. Modiva deletes the stored token immediately. You can also revoke Modiva from inside Meta Ads's own app settings.

Which ad account does Modiva use?

If you have access to multiple ad accounts, you'll select the one to manage during connect. You can connect additional ad accounts separately.

Need help with Meta Ads?

Fin can answer follow-up questions and walk you through any step.


Related connections

Google Ads
TikTok Ads
LinkedIn Ads
Pinterest Ads
X Ads