Skip to content
Convor
Convor Docs
API ReferenceAutomation Rules

List content channel accounts

List connected provider accounts owned by the selected organization and project.

GET/api/automation-rules/accounts

List connected provider accounts owned by the selected organization and project. Account IDs can restrict rule and knowledge availability.

Endpoint requirements

Credentials
Use either Bearer API key or X-API-Key header.
Required scope
automation-rules:read
Module
Automation & API module (api_access)
Organization and site scope
single-project
Retry behavior
Safe read: You can safely retry this read-only request after a transport failure. It does not change resource state.

Header Parameters

X-Project-Id?|

DA-4035: selects the active site (project) for project-scoped operations. Accepts a site UUID, or the literal all to aggregate across every accessible site on read-only aggregate routes (single-or-all-read). Mutations and single-site routes reject all. Path-owned project routes (/api/projects/{projectId}/…) resolve the site from the URL and ignore this header. Conflicting selectors across header/query/body/path return PROJECT_CONTEXT_CONFLICT (400); an archived site returns PROJECT_ARCHIVED (410).

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

{  "data": [    {      "channel": "messenger",      "id": "11111111-1111-4111-8111-111111111111",      "label": "example",      "connected": true    }  ]}

Request examples

curl

curl --request GET \
  'https://api.convor.io/api/automation-rules/accounts' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer convor_sk_...'

JavaScript

const response = await fetch("https://api.convor.io/api/automation-rules/accounts", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer convor_sk_..."
  },
});

const contentType = response.headers.get("content-type") ?? "";
const data = response.status === 204
  ? null
  : contentType.includes("json")
    ? await response.json()
    : contentType.startsWith("text/")
      ? await response.text()
      : await response.blob();

if (!response.ok) {
  const message = typeof data === "object" && data !== null
    && "error" in data && typeof data.error === "object"
    && data.error !== null && "message" in data.error
      ? String(data.error.message)
      : "Convor API request failed (" + response.status + ")";
  throw new Error(message);
}

console.log(data);

Was this page helpful?

On this page