Project Settings — Social Accounts

/project/{projectId}/project-settings/social-accounts redirects by default to the Connected tab. A sibling tab, Managed, is for accounts Layers operates on your behalf.

Connected Accounts

• Two connect buttons: TikTok and Instagram. YouTube, X, and LinkedIn are not wired in the current UI — only TikTok and Instagram are supported.
• The list below shows already-connected accounts filtered to those where discovery_source is null or "oauth" (i.e. connected here, not discovered via SIFT).
• Each row has actions to reconnect (re-run OAuth and rebind to the existing entry) or remove.

Connecting a new account

1. Click TikTok or Instagram. An OAuth popup opens.
2. Grant scopes. The hook resolves which account to attach.
3. On success, Layers provisions the social-account onboarding system layer, which creates per-account layers (Social Distribution, Social Engagement, Account Health Monitor) and ensures a Social Content layer exists and is wired through.

Reconnect

Used when a token has been revoked or expired. The flow re-runs the same OAuth but rebinds the token to the existing social_accounts row — the row's history is preserved.

Remove

Opens a confirmation dialog and then deletes the account + any layers bound to it. Existing scheduled posts on that account are cancelled as part of the deletion flow.

Managed Accounts

See Managed accounts. Not OAuth — provisioned by a Layers CSM.