Manage accounts

Once accounts are linked, these endpoints let you manage them.

List accounts

GET /v1/accounts

curl https://api.correctinbox.com/v1/accounts \
  -H "X-API-KEY: $CORRECTINBOX_API_KEY"

const { accounts } = await (
  await fetch("https://api.correctinbox.com/v1/accounts", {
    headers: { "X-API-KEY": process.env.CORRECTINBOX_API_KEY },
  })
).json();

accounts = requests.get(
    "https://api.correctinbox.com/v1/accounts",
    headers={"X-API-KEY": os.environ["CORRECTINBOX_API_KEY"]},
).json()["accounts"]

Response

{
  "accounts": [
    {
      "id": "acc_8f21c0",
      "provider": "LINKEDIN",
      "name": "Aditya Sharma",
      "status": "connected",
      "region": "IN",
      "created_at": "2026-02-01T09:12:00Z",
      "last_checked_at": "2026-02-01T18:40:00Z"
    }
  ]
}

Retrieve one account

GET /v1/accounts/{account_id}

curl https://api.correctinbox.com/v1/accounts/acc_8f21c0 \
  -H "X-API-KEY: $CORRECTINBOX_API_KEY"

Reconnect an account

If an account becomes disconnected, generate a fresh hosted link to bring it back online. The account keeps its id, history and campaigns.

POST /v1/accounts/{account_id}/reconnect

curl -X POST https://api.correctinbox.com/v1/accounts/acc_8f21c0/reconnect \
  -H "X-API-KEY: $CORRECTINBOX_API_KEY"

const { url } = await (
  await fetch("https://api.correctinbox.com/v1/accounts/acc_8f21c0/reconnect", {
    method: "POST",
    headers: { "X-API-KEY": process.env.CORRECTINBOX_API_KEY },
  })
).json();

url = requests.post(
    "https://api.correctinbox.com/v1/accounts/acc_8f21c0/reconnect",
    headers={"X-API-KEY": os.environ["CORRECTINBOX_API_KEY"]},
).json()["url"]

Remove an account

Disconnects the account and deletes its stored session. Campaign history is retained; running campaigns on it stop.

DELETE /v1/accounts/{account_id}

curl -X DELETE https://api.correctinbox.com/v1/accounts/acc_8f21c0 \
  -H "X-API-KEY: $CORRECTINBOX_API_KEY"