Catalog connection token expiry stopping Meta or TikTok sync
A merchant whose connection used to work sees sync stop with a reauth_required status or a token-expiry warning chip on the platform card in /dashboard/catalog-sync.
Why this happens
Because platform tokens expire or get revoked: an authorization rejection from Meta or TikTok flips the connection to reauth_required, and the Meta token shows a warning chip at 7 days or less. Authorization errors are not fixed by ordinary retries because the credential itself — not the item — is the problem.
What Vareons does about it
Vareons surfaces the connection status, the token-expiry chip, and a reconnect action on the platform card (per the facts registry): Meta reconnects with a fresh OAuth click, TikTok by pasting a new valid token. Tokens are stored encrypted and never shown to the client.
- marketing.catalog-sync.supported — Catalog Sync support: Available
- marketing.catalog-sync.meta.supported — Meta catalog sync support: Available
- marketing.catalog-sync.tiktok.supported — TikTok catalog sync support: Available
Limitations
The current facts registry does not claim that Vareons silently renews Meta or TikTok tokens in the background. Reconnecting is a manual merchant action. Any future automatic renewal must be documented as a separate claim before stating it here.
Related problems
Frequently Asked Questions
Sync stopped suddenly, should I reconnect at once?
Check the connection state on the platform card first: when a re-authentication state or an expiry chip shows, reconnect from the same card. When the state reads connected, look for another cause before touching credentials.
Why is retrying not enough after an authorization rejection?
Because the credential itself is the problem rather than the synced item, so resending the same rejected token repeats the same result. Reconnect with fresh valid credentials, then let sync continue where it stopped.
Does the system renew tokens automatically in the background?
The facts registry claims no silent background renewal of Meta or TikTok tokens, and reconnecting stays a manual merchant action. Watch the expiry chip and reconnect early before sync comes to a halt.
Last verified: 2026-09-19