Register an account directly with credentials. For most users the interactive OAuth flow is simpler and safer.
POST
/v1/accountsAPI key (dra_…) or dashboard JWT
Register a platform account manually with credentials (BYOK). For interactive connection use the OAuth flow instead.
Body & query parameters
platformstringrequiredinstagram | facebook | x | linkedin | tiktok.
platform_account_idstringrequiredAccount ID on the platform.
handlestringDisplay handle.
credentialsobjectrequiredMust include access_token; platform-specific extras (page_id, ig_user_id, author_urn).
const response = await fetch("https://api.dravo.dev/v1/accounts", { method: "POST", headers: { "Authorization": "Bearer " + process.env.DRAVO_API_KEY, "Content-Type": "application/json",}, body: JSON.stringify({ "platform": "x", "platform_account_id": "1890123", "handle": "@dravo", "credentials": { "access_token": "…" }})});const data = await response.json();console.log(data);{ "id": "acc_8f2c1d", "platform": "x", "health": "active"}