# Connectors

### Connectors

Connectors are integrations that link your CRM and sales tools to Saber, enabling enriched research and automated data syncing.

Use this section to list all configured connectors and inspect their connection status. This is useful for verifying that the integrations your workflows depend on are active before running signals or batch operations.

**Supported connectors:**

* **LinkedIn Sales Navigator** (`salesNavigator`) — Contact search and profile enrichment
* **HubSpot App** (`hubspotApp`) — OAuth-based HubSpot marketplace app installation

## List connectors and their connection status

> 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\
> \
> \| Source | Description |\
> \|---|---|\
> \| \`salesNavigator\` | LinkedIn Sales Navigator — used for contact search and profile enrichment |\
> \| \`hubspotApp\` | HubSpot App — OAuth-based HubSpot marketplace app installation |\
> \
> \## Connection Statuses\
> \
> \| Status | Meaning |\
> \|---|---|\
> \| \`connected\` | The connector is authenticated and operational |\
> \| \`disconnected\` | The connector has been manually disconnected |\
> \| \`needs-authentication\` | The connector's credentials have expired and require re-authentication |\
> \| \`ready-to-connect\` | The connector is configured but not yet connected |\
> \| \`error\` | An 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<br>

```json
{"openapi":"3.0.3","info":{"title":"Saber Platform API","version":"1.0.0"},"tags":[{"name":"Connectors","description":"## Connectors\n\nConnectors are integrations that link your CRM and sales tools to Saber, enabling enriched\nresearch and automated data syncing.\n\nUse this section to list all configured connectors and inspect their connection status.\nThis is useful for verifying that the integrations your workflows depend on are active before\nrunning signals or batch operations.\n\n**Supported connectors:**\n- **LinkedIn Sales Navigator** (`salesNavigator`) — Contact search and profile enrichment\n- **HubSpot App** (`hubspotApp`) — OAuth-based HubSpot marketplace app installation\n"}],"servers":[{"url":"https://api.saber.app","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"API key authentication using Bearer token. Format: sk_live_ followed by a secure random string."}},"schemas":{"ConnectorsListResponse":{"type":"object","properties":{"connectors":{"type":"array","description":"List of connectors configured for the organization","items":{"$ref":"#/components/schemas/Connector"}}},"required":["connectors"]},"Connector":{"type":"object","description":"A data integration connector and its current connection status","properties":{"source":{"type":"string","description":"The connector type identifier","enum":["salesNavigator","hubspotApp"]},"status":{"type":"string","description":"The current connection status of the connector","enum":["connected","disconnected","needs-authentication","ready-to-connect","error"]}},"required":["source","status"]},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","description":"Error code"},"message":{"type":"string","description":"Human-readable error message"},"details":{"type":"array","description":"Additional error details (optional)","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}}}}},"required":["error","message"]}}},"paths":{"/v1/connectors":{"get":{"summary":"List connectors and their connection status","description":"Returns a list of all integrations (connectors) configured for your organization, along with\ntheir current connection status. Use this endpoint to check which data sources are connected\nto Saber and whether they are actively syncing.\n\n## Supported Connectors\n\n| Source | Description |\n|---|---|\n| `salesNavigator` | LinkedIn Sales Navigator — used for contact search and profile enrichment |\n| `hubspotApp` | HubSpot App — OAuth-based HubSpot marketplace app installation |\n\n## Connection Statuses\n\n| Status | Meaning |\n|---|---|\n| `connected` | The connector is authenticated and operational |\n| `disconnected` | The connector has been manually disconnected |\n| `needs-authentication` | The connector's credentials have expired and require re-authentication |\n| `ready-to-connect` | The connector is configured but not yet connected |\n| `error` | An error occurred with the connector |\n\n> **Note:** `hubspotApp` connection state is inferred from the presence of an active\n> installation record. As a result, it can only be reported as `connected` or omitted\n> entirely — finer-grained statuses such as `needs-authentication` or `error` are not\n> currently available for this connector.\n\n## Common Use Cases\n\n- **Pre-flight checks** — verify that the required connectors are connected before running a workflow\n- **Monitoring** — detect connectors that need re-authentication or have stopped syncing\n- **Automation** — programmatically surface connector health in dashboards or alerting systems\n","operationId":"listConnectors","tags":["Connectors"],"responses":{"200":{"description":"List of connectors retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectorsListResponse"}}}},"401":{"description":"Unauthorized - Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```