Connectors

List connectors and their connection status

GET
/v1/connectors

Returns a list of all integrations (connectors) configured for your organization, along with their current connection status. Use this endpoint to check which data sources are connected to Saber and whether they are actively syncing.

Supported Connectors

SourceDescription
salesNavigatorLinkedIn Sales Navigator — used for contact search and profile enrichment
hubspotAppHubSpot App — OAuth-based HubSpot marketplace app installation

Connection Statuses

StatusMeaning
connectedThe connector is authenticated and operational
disconnectedThe connector has been manually disconnected
needs-authenticationThe connector's credentials have expired and require re-authentication
ready-to-connectThe connector is configured but not yet connected
errorAn error occurred with the connector

Note: hubspotApp connection state is inferred from the presence of an active installation record. As a result, it can only be reported as connected or omitted entirely — finer-grained statuses such as needs-authentication or error are not currently available for this connector.

Common Use Cases

  • Pre-flight checks — verify that the required connectors are connected before running a workflow
  • Monitoring — detect connectors that need re-authentication or have stopped syncing
  • Automation — programmatically surface connector health in dashboards or alerting systems

Authorization

ApiKeyAuth
AuthorizationBearer <token>

API key authentication using Bearer token. Format: sk_live_ followed by a secure random string.

In: header

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/connectors"

{  "connectors": [    {      "source": "salesNavigator",      "status": "connected"    },    {      "source": "hubspotApp",      "status": "connected"    }  ]}

{  "error": {    "type": "VALIDATION",    "code": "VALIDATION_ERROR",    "message": "validation failed for 'departments': invalid value: Engineering Ops",    "errorCode": "string",    "errorAction": "string",    "details": {},    "requestId": "e69ed773-2674-4dca-be61-886d6698f360",    "fields": [      {        "field": "domain",        "message": "'domain' must be a valid hostname (e.g., 'example.com') without protocol (https://) or path"      }    ],    "debug": {      "cause": "string"    }  }}
{  "error": {    "type": "VALIDATION",    "code": "VALIDATION_ERROR",    "message": "validation failed for 'departments': invalid value: Engineering Ops",    "errorCode": "string",    "errorAction": "string",    "details": {},    "requestId": "e69ed773-2674-4dca-be61-886d6698f360",    "fields": [      {        "field": "domain",        "message": "'domain' must be a valid hostname (e.g., 'example.com') without protocol (https://) or path"      }    ],    "debug": {      "cause": "string"    }  }}

On this page

List connectors and their connection status