Connect Outbrain Amplify

Connect Outbrain Amplify at /connect/outbrain by pasting an API token (no OAuth). Token valid 30 days, marketers import as ad accounts.

Written By Salvatore Sinigaglia

Last updated About 2 hours ago

Connect Outbrain Amplify at /connect/outbrain by pasting an API token (no OAuth). Token valid 30 days, marketers import as ad accounts.

Connect Outbrain Amplify

Outbrain uses token-paste, not OAuth. Open /connect/outbrain, paste your Outbrain Amplify API token, and Wevion validates it against Outbrain's /marketers endpoint and imports every accessible marketer as an ad account. The token is valid 30 days — there is no refresh, so you regenerate and re-paste it before it expires.

Who is this for

Mediabuyers, admins, and owners running native advertising on Outbrain's premium-publisher network (CNN, BBC, and similar). Connecting requires an active subscription and available ad-account quota — the connect call passes the same per-plan ad_accounts quota guard as Taboola and Google, so imported marketers count toward your plan limit.

Before you start

You need:

  • An Outbrain Amplify account with at least one accessible marketer
  • An Outbrain Amplify API token generated from your Outbrain dashboard (my.outbrain.com)
  • A Wevion plan with an active subscription and ad-account quota available

How token-paste connection works

Unlike Meta, Google, TikTok, or Snapchat (which use OAuth pop-ups), Outbrain is a credentials-only platform in Wevion. You generate the token in Outbrain and paste it into Wevion's Connect dialog — no redirect, no consent screen.

Step 1: Generate the token in Outbrain

In your Outbrain Amplify dashboard, generate an API token (format OB-TOKEN-V1). Copy it in full.

Step 2: Open the connector page

In Wevion, go to Connect → Outbrain or visit /connect/outbrain. The page shows the Outbrain integration card and the list of synced marketers (empty until you connect).

Step 3: Paste the token

Open the Connect dialog and paste the token. Wevion sends it to POST /api/v1/outbrain/connect-token, which:

  1. Validates the token by calling Outbrain's /marketers endpoint (the cheapest auth check Outbrain exposes)
  2. Persists it encrypted for your session, recording a 30-day expiry
  3. Upserts every accessible marketer as an outbrain_ad_account row, marked connected

If the token is valid but has no accessible marketers, Wevion returns an error asking you to check the user's Outbrain permissions.

Step 4: First sync

Right after a successful connect, Wevion fires three background syncs so the Ads Manager and campaign wizard populate before the next 15-minute cron tick:

  • Ad accounts (marketer list)
  • Conversion events (goals)
  • Campaigns

What you'll see when it works

  • The /connect/outbrain page shows a connected count on the integration card
  • The marketers table lists each marketer with name, ID, and currency
  • Outbrain campaigns appear in the Ads Manager once the campaign sync lands

Token expiry and re-connect

Outbrain tokens are not auto-refreshed. The token TTL is 30 days; before it expires you must regenerate it in Outbrain and paste the new value again at /connect/outbrain. When the stored token is expired or rejected, Wevion surfaces an authentication-style error.

Re-syncing marketers

To refresh the marketer list, conversion goals, and campaigns without re-pasting the token, use the re-sync action. It calls POST /api/v1/outbrain/ad-accounts/sync, which first checks that an active Outbrain token exists, then queues marketer, conversion-event, and campaign syncs.

Conversion goals

Outbrain conversion goals are read per marketer via GET /api/v1/outbrain/conversion-goals?account_id=<marketer_id>. Wevion serves them from a local cache first and falls back to a live Outbrain fetch when the cache is empty.

Important: the 15-minute cron does not periodically re-pull conversion goals. If you add a new goal in the Outbrain dashboard, hit Re-sync in Wevion so the wizard dropdown picks it up.

Managing Outbrain campaigns

From the Ads Manager, Wevion supports two live actions against Outbrain campaigns (each queued as a background worker):

ActionEndpointNotes
Pause / resumePOST /api/v1/outbrain/campaigns/:campaignId/toggleEnable or pause a campaign for the marketer account
Edit budgetPOST /api/v1/outbrain/campaigns/:campaignId/budgetSet a new amount with pacing DAILY, MONTHLY, or ENTIRE

Outbrain models budget as a separate Budget entity linked to the campaign. Wevion resolves the budget id from the local campaign cache, so if the cache is empty you'll be asked to run a sync before editing the budget.

Disconnecting

Disconnecting calls POST /api/v1/outbrain/disconnect, which revokes the stored token state and soft-deletes the cached marketers. Your historical data is preserved; only the ongoing sync stops.

Common issues

  • "Token Outbrain non valido": the token was copied partially or is wrong. Regenerate it in Outbrain and paste the full value.
  • "No accessible marketers": the token is valid but the Outbrain user has no marketer access. Fix permissions in Outbrain, then reconnect.
  • New conversion goal missing from the wizard: the cron does not re-pull goals — click Re-sync.
  • "Budget Outbrain non trovato": the campaign budget isn't cached yet. Run a sync, then retry the budget edit.
  • Quota error on connect: connecting imports every marketer as an ad account and counts toward your plan's ad_accounts quota. Free up quota or upgrade.

Security

  • The Outbrain token is encrypted at rest (OUTBRAIN_TOKEN_ENCRYPTION_KEY)
  • Connection is session-scoped; disconnect revokes it and soft-deletes marketers
  • Wevion only reads what's needed for native-ad management

FAQ

Does Outbrain use OAuth in Wevion?

No. Outbrain Amplify is a credentials-only platform in Wevion, so you connect by pasting an API token instead of going through an OAuth pop-up. Wevion validates the pasted token against Outbrain's /marketers endpoint at POST /api/v1/outbrain/connect-token, then imports each accessible marketer as an ad account. Meta, Google, TikTok, and Snapchat use OAuth; Outbrain does not.

How long is the Outbrain token valid?

The Outbrain Amplify API token is valid for 30 days, and Wevion does not auto-refresh it. Before the token expires you must regenerate it in your Outbrain dashboard and paste the new value again at /connect/outbrain. When the stored token is expired or rejected, Wevion shows an authentication-style error prompting you to reconnect.

Why don't my new Outbrain conversion goals appear?

Wevion caches Outbrain conversion goals and the 15-minute cron does not periodically re-pull them. After you create a new goal in the Outbrain dashboard, use the Re-sync action at /connect/outbrain — it re-fetches marketers, conversion events, and campaigns so the new goal shows up in the campaign wizard dropdown.

What happens to my data if I disconnect Outbrain?

Disconnecting Outbrain in Wevion revokes the stored token and soft-deletes the cached marketers, but your historical data is preserved — only the ongoing sync stops. To reconnect later, generate a fresh Outbrain API token and paste it again at /connect/outbrain; marketers re-import and sync resumes.