Connecting Meta Ads

Meta Ads is the richest integration in nordenagent today. Connecting it takes three pieces of information: a Meta App, an ad account ID, and a long-lived user token with ads_management scope.

What you need before you start

1. A Meta Business account with a Meta App in Developer mode or Live mode.
2. The Meta App ID and App Secret — you will find both under Settings → Basic in Meta for Developers.
3. An ad account you have Admin access on. Copy the numeric Ad Account ID from the URL in Ads Manager.
4. A long-lived Page access token with ads_read + ads_management scopes. Generate it via the Graph API Explorer, then exchange it for a 60-day token.

Wire it in nordenagent

Open Settings → Integrations, click Connect on the Meta row, and paste the four fields. Before the integration is saved, nordenagent calls a verify() probe against the Graph API to make sure the token actually works. If verification fails, you see the exact error the Graph API returned — no silent half-connections.

When the token expires

Long-lived tokens last about 60 days. When yours is within 7 days of expiry, nordenagent raises a warning banner on the dashboard and emails the workspace owner. You refresh by generating a new token in Graph API Explorer and pasting it back into the Integrations page — the old one is replaced atomically.

Disconnecting

Hit the Disconnect button on the Meta row. The stored secret is removed from Vault in the same transaction as the integration row, and any queued jobs that would have used it are cancelled on their next tick.