Connect a Meta ad account
Ads
Connect a Meta ad account
Links a Meta (Facebook) ad account to this workspace by storing an OAuth access token and the selected ad account id. Call it once after the user authorizes in Facebook; the token is encrypted at rest and reused by the campaigns, audiences, and Conversions API endpoints. The response warns when no Conversions API dataset id is configured yet. Owner or admin only.
POST
Connect a Meta ad account
Authorizations
Dashboard JWT token from Clerk
Response
200 - application/json
The connected ad_account_id and a connected flag — plus a warning when no Conversions API dataset id is set — inside the standard { data, meta } envelope.
The response is of type object.