Connection status

Every account carries a status. Because outreach runs against a live platform, status can change on its own — build for it.

Statuses

Status	Meaning	What to do
connected	The account is operational and ready for methods.	Nothing.
connecting	A hosted link was created but the user hasn't finished.	Wait, or resend the link.
disconnected	The session is no longer valid.	Reconnect the account.

Checking status

Poll the account, or — better — subscribe to webhooks and react to account.connected and account.disconnected events.

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

const acc = await (
  await fetch("https://api.correctinbox.com/v1/accounts/acc_8f21c0", {
    headers: { "X-API-KEY": process.env.CORRECTINBOX_API_KEY },
  })
).json();
if (acc.status === "disconnected") {
  // prompt the user to reconnect
}

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

Limited access on new accounts

A connected account can still have limited access to some actions. New or low‑standing provider accounts are often restricted from people search and high‑volume actions until they are more established on the platform.

This shows up as empty results (for example, a search that returns nothing on a real keyword), not as an error. It is a property of that account on the provider, not a problem with your request or the API. To resolve it, let the account mature — complete its profile, make a few connections, use it normally — or run the action on a more established account.