---
title: "Connect account"
description: "Register an account directly with credentials (advanced BYOK)."
section: "API reference"
url: https://dravo.dev/docs/api/accounts/connect
---
# Connect account

Register an account directly with credentials. For most users the interactive
[OAuth flow](/docs/api/oauth) is simpler and safer.

#### `POST /v1/accounts`

Register a platform account manually with credentials (BYOK). For interactive connection use the OAuth flow instead.

**Auth:** API key (`dra_…`) or dashboard JWT

| Field | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `platform` | body | string | yes | instagram \| facebook \| x \| linkedin \| tiktok. |
| `platform_account_id` | body | string | yes | Account ID on the platform. |
| `handle` | body | string | no | Display handle. |
| `credentials` | body | object | yes | Must include access_token; platform-specific extras (page_id, ig_user_id, author_urn). |

Request:

```json
{
  "platform": "x",
  "platform_account_id": "1890123",
  "handle": "@dravo",
  "credentials": {
    "access_token": "…"
  }
}
```

Response `201`: Account connected.

```json
{
  "id": "acc_8f2c1d",
  "platform": "x",
  "health": "active"
}
```