Use the connect flow when a user needs to connect Instagram, Facebook, X, LinkedIn or TikTok. Dravo gives you a connect URL, the user approves on the platform, and Dravo creates the connected account.
Platform credentials are the client_id and client_secret from your own
developer app on Meta, X, LinkedIn, TikTok or another platform. They are not
social accounts; they are the credentials Dravo uses to start the connection.
Background: BYOK.
These endpoints accept an API key or a JWT, so you can run the whole flow from your own backend, including connecting your end users' accounts. For the end-to-end walkthrough see Connect accounts via the API.
Configure the real developer app before starting OAuth. The exact console steps, products, callback rules, scopes and review requirements are documented for Instagram, Facebook, X, LinkedIn, and TikTok.
The platform callback and your product return URL are different. Register the
returned redirect_uri in the social platform. Use return_url only to send the
browser from Dravo back to an allowlisted route in your product.
Each endpoint lives on its own page:
- Get connect URL:
GET /v1/oauth/{platform}/start - Add platform credentials:
POST /v1/oauth-apps - List platform credentials:
GET /v1/oauth-apps - Delete platform credentials:
DELETE /v1/oauth-apps/{oauth_app_id}