Skip to main content

​
Overview

The Connectors API allows you to manage connectors programmatically.

​
Endpoints

​
Create Activation Token

POST /api/connectors/create-token
Generate a new activation token for a connector. Response: 
{
  "token": "act_abc123...",
  "expires_at": "2024-01-01T12:00:00Z"
}

​
Activate Connector

POST /api/connectors/activate
Activate a connector using an activation token. Request: 
{
  "token": "act_abc123...",
  "name": "Office Main Computer"
}

​
List Connectors

GET /api/connectors
Get a list of all connectors for your organization.

​
Get Connector

GET /api/connectors/{id}
Get details about a specific connector.

​
Connector Heartbeat

POST /api/connectors/{id}/heartbeat
Send a heartbeat to indicate the connector is alive.

​
Next Steps

Ingestion API

Ingest audit events

MCP Tools

MCP tool reference