Connecting Social Accounts
PromotiAI uses a Bring Your Own App (BYOA) model. Before clicking "Connect" you first create a developer app on the platform's developer console to obtain an App ID and App Secret. This gives you full ownership of the OAuth connection and keeps your credentials under your control.
Supported Platforms
- Facebook & Instagram — via Meta Developer App
- Google / YouTube — via Google Cloud Console OAuth client
- TikTok — via TikTok for Developers App
- LinkedIn — via LinkedIn Developer App
- Twitter / X — via X Developer App
Two-Step Connection Flow
- Create a developer app on the platform's developer console and copy the App ID and App Secret (takes 5–10 minutes per platform).
- Enter your credentials in PromotiAI: go to Settings → Integrations, click the platform card, and choose either Quick Setup (paste App ID & Secret, click Connect) or Step-by-Step Guide (walk through each developer-console step with screenshots).
Once credentials are saved, PromotiAI starts the OAuth redirect — you log in to the platform and grant the required permissions. The connection activates immediately.
Credential Security
Your App Secret is encrypted at rest using AES-256-CBC before being stored. Only your workspace can decrypt and use it.
Troubleshooting
- Ensure you have Admin access to the ad accounts you want to sync
- Disable browser ad-blockers during the OAuth popup
- If authorization fails, verify the callback URL in your developer app matches the one shown in the PromotiAI setup modal
- Re-connect from Settings → Integrations if a token expires