Skip to content

List installed connectors

GET/integrations/connectors

Returns a paginated list of all installed connector accounts ordered by most recently updated, with field mapping counts. Use this to manage active integrations and quickly identify connectors that need re-authentication.

Request

Query parameters

NameTypeRequiredDescription
pageintegerNo

Page number (15 connectors per page).

Default: 1

Responses

200 Paginated connector list with mapping counts

Content type application/json, object.

FieldTypeRequiredDescription
dataarray of object · ConnectorAccountV1No
data[].idintegerNo

Auto-incremented primary key.

data[].namestringNo

Display name of the connector.

Example: "Salesforce CRM"

data[].keystringNo

Machine-readable slug identifier.

Example: "salesforce_crm"

data[].typestringNo

Category of the external system.

One of: "crm", "support", "analytics", "messaging", "storage", "custom" · Example: "crm"

data[].auth_typestringNo

Authentication mechanism.

One of: "api_key", "oauth2", "none" · Example: "oauth2"

data[].statusstringNo

Operational status. 'error' means authentication or sync has failed.

One of: "active", "inactive", "error" · Example: "active"

data[].field_mappings_countintegerNo

Number of field mappings configured for this connector.

Example: 18

data[].configobject, nullableNo

Non-sensitive connector configuration.

data[].updated_atstring (date-time)No

Timestamp of the last update.

Example

{
  "data": [
    {
      "id": 4,
      "name": "Salesforce CRM",
      "key": "salesforce_crm",
      "type": "crm",
      "auth_type": "oauth2",
      "status": "active",
      "field_mappings_count": 18,
      "updated_at": "2026-04-06T10:00:00Z"
    }
  ]
}

401 Unauthenticated

Example request

curl -X GET "https://{tenant}.faciotech.net/api/v1/integrations/connectors" \
  -H "Accept: application/json"
Loading