Create Integration

{
  "name": "Twilio Production",
  "credentials": {
    "provider": "twilio",
    "account_sid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "auth_token": "your_twilio_auth_token"
  }
}

{
  "success": true,
  "message": "Integration created successfully",
  "data": {
    "integration_id": "intg_a1b2c3d4e5f6",
    "client_id": "org_abc123",
    "name": "Twilio Production",
    "provider": "twilio",
    "category": "telephony",
    "status": "active",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

POST

api

integrations

{
  "name": "Twilio Production",
  "credentials": {
    "provider": "twilio",
    "account_sid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "auth_token": "your_twilio_auth_token"
  }
}

{
  "success": true,
  "message": "Integration created successfully",
  "data": {
    "integration_id": "intg_a1b2c3d4e5f6",
    "client_id": "org_abc123",
    "name": "Twilio Production",
    "provider": "twilio",
    "category": "telephony",
    "status": "active",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

Create a new integration with external service credentials (e.g., Twilio). Integrations enable your agents to make and receive calls through your own telephony provider accounts.

Headers

string

required

Your API key for authentication.

string

required

The organization ID.

string

required

Must be application/json.

Permissions

integrations:create (admin, agent_manager)

Request Body

string

required

A human-readable name for the integration (1-100 characters).

object

required

Provider-specific credentials object. The structure depends on the provider.

Show Twilio Credentials

string

required

Must be twilio.

string

required

Your Twilio Account SID (starts with AC).

string

required

Your Twilio Auth Token.

Response

boolean

Indicates if the request was successful.

string

Human-readable success message.

object

The created integration object.

Show properties

string

Unique integration identifier (format: intg_[a-f0-9]{12}).

string

The organization/client ID this integration belongs to.

string

The name of the integration.

string

The provider type (e.g., twilio).

string

The category (e.g., telephony).

string

Current status (active or invalid).

string

ISO 8601 timestamp of creation.

string

ISO 8601 timestamp of last update.

{
  "name": "Twilio Production",
  "credentials": {
    "provider": "twilio",
    "account_sid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "auth_token": "your_twilio_auth_token"
  }
}

{
  "success": true,
  "message": "Integration created successfully",
  "data": {
    "integration_id": "intg_a1b2c3d4e5f6",
    "client_id": "org_abc123",
    "name": "Twilio Production",
    "provider": "twilio",
    "category": "telephony",
    "status": "active",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T10:30:00Z"
  }
}

List Integrations Get Integration

Introduction

Agents

Phone Numbers

Calls

Knowledge Base

Tools

Organizations

Billing

Analytics

Preview & Voice Selection

Integrations

API Keys

Create Integration

Headers

Permissions

Request Body

Response

​Headers

​Permissions

​Request Body

​Response

Headers

Permissions

Request Body

Response