Quickstart

This guide takes you from zero to a published post. It should take a few minutes.

Before you start

You need a Dravo account and at least one social account connected through the BYOK flow. If you have not connected anything yet, open the dashboard, go to Connections, and follow Authentication plus the per network notes for the platform you want.

Step 1. Create an API key

In the dashboard, open Keys and create a key. Copy it now: the secret is shown once and never again. Keys look like dra_live_... or dra_test_....

export DRAVO_API_KEY="dra_live_..."

Step 2. Connect an account

Connect an account in the dashboard (Connections). Each connected account has an id you will pass to the publish endpoint. List them with:

curl https://api.dravo.dev/v1/accounts \
  -H "Authorization: Bearer $DRAVO_API_KEY"

{
  "items": [
    { "id": "acc_8f2c1d", "provider": "x", "handle": "@dravo", "health": "active" }
  ],
  "next_cursor": null,
  "total": 1
}

Step 3. Publish

Send the content to one or more accounts. Delivery is asynchronous, so this returns right away with a job id.

curl -X POST https://api.dravo.dev/v1/publish \
  -H "Authorization: Bearer $DRAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_ids": ["acc_8f2c1d"],
    "text": "Hello from Dravo, one API for every social network."
  }'

const res = await fetch("https://api.dravo.dev/v1/publish", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.DRAVO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    account_ids: ["acc_8f2c1d"],
    text: "Hello from Dravo, one API for every social network.",
  }),
});
const job = await res.json(); // { job_id, status: "queued" }

To attach media, ingest it first with POST /v1/media and pass the returned public_url in media_urls.

Step 4. Check the result

The response is a job, not the final outcome. Poll the publish history to see the per account delivery result.

curl "https://api.dravo.dev/v1/publish?limit=1" \
  -H "Authorization: Bearer $DRAVO_API_KEY"

A status of published means it went out, partial means some accounts succeeded and others failed, and failed means none did. Read Async publishing for the full lifecycle, and Errors for how to interpret failures.