> ## Documentation Index
> Fetch the complete documentation index at: https://www.voiceflow.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrations

API operations for integrations. Browse the routes below for parameters, request examples, and responses.

API version: Selected per operation

## List integrations

Returns the integrations a project can use and whether each is connected. `connectionType` says how credentials arrive: `api-key` ones connect through this API, `oauth` and `app` ones only through the Voiceflow UI. The call is unpaginated: it takes no paging parameters, so one request yields the whole set.

### Endpoint

```http
GET /v1/stable/integration
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

### Responses

#### 200

Returns one entry per integration the project can use, each with its identifier, display name, connection type, whether credentials are stored, and whether this API can connect it.

Schema:

```json
{
  "$ref": "#/components/schemas/StableIntegrationListResponse"
}
```

Example:

```json
{
  "integrations": [
    {
      "integration": "<ProjectIntegration>",
      "name": "<string>",
      "connectionType": "<IntegrationConnectionType>",
      "connected": true,
      "connectableViaAPI": true
    }
  ]
}
```

### Request examples

#### cURL

```bash
curl --request GET \
  --url 'https://realtime-api.voiceflow.com/v1/stable/integration?projectID=<projectID>' \
  --header 'Authorization: Bearer <token>'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/integration?projectID=<projectID>', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.get(
    'https://realtime-api.voiceflow.com/v1/stable/integration?projectID=<projectID>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf integration list --project-id <projectID>
```


## Connect integration

Stores the credentials for one `api-key` integration on the project, in the shape that integration expects; `oauth` and `app` integrations connect through the Voiceflow UI instead. The response carries only a confirmation message, so refetch the integration list to see the connection.

### Endpoint

```http
POST /v1/stable/integration/{integration}
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Path parameters

#### `integration`

Required · string

The integration identifier, as `GET /v1/stable/integration` lists it (for example `twilio`).

```json
{
  "type": "string"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

### Request body

Required

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StableIntegrationConnectRequest"
      }
    }
  }
}
```

### Responses

#### 200

Confirms the credentials were stored. The body is a message only, so refetch the integration list to see `connected` flip for this integration.

Schema:

```json
{
  "$ref": "#/components/schemas/StableUpdateResponse"
}
```

Example:

```json
{
  "message": "<string>"
}
```

### Request examples

#### cURL

```bash
curl --request POST \
  --url 'https://realtime-api.voiceflow.com/v1/stable/integration/<integration>?projectID=<projectID>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "integration": "eleven_labs",
  "credentials": "<string>"
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/integration/<integration>?projectID=<projectID>', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "integration": "eleven_labs",
    "credentials": "<string>"
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.post(
    'https://realtime-api.voiceflow.com/v1/stable/integration/<integration>?projectID=<projectID>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "integration": "eleven_labs",
      "credentials": "<string>"
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf integration connect --integration <integration> --project-id <projectID> <<'JSON'
{
  "integration": "eleven_labs",
  "credentials": "<string>"
}
JSON
```


## Disconnect integration

Clears the stored credentials for one integration on the project, every slot it owns. The response carries only a confirmation message, so refetch the integration list to see it disconnected.

### Endpoint

```http
DELETE /v1/stable/integration/{integration}
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Path parameters

#### `integration`

Required · string

The integration identifier, as `GET /v1/stable/integration` lists it (for example `twilio`).

```json
{
  "type": "string"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

### Responses

#### 200

Confirms the integration was disconnected. The body is a message only, so refetch the integration list to see `connected` turn false.

Schema:

```json
{
  "$ref": "#/components/schemas/StableDeleteResponse"
}
```

Example:

```json
{
  "message": "<string>"
}
```

### Request examples

#### cURL

```bash
curl --request DELETE \
  --url 'https://realtime-api.voiceflow.com/v1/stable/integration/<integration>?projectID=<projectID>' \
  --header 'Authorization: Bearer <token>'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/integration/<integration>?projectID=<projectID>', {
  method: 'DELETE',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.delete(
    'https://realtime-api.voiceflow.com/v1/stable/integration/<integration>?projectID=<projectID>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf integration disconnect --integration <integration> --project-id <projectID>
```


## Get integration tool schemas

Returns the tools one integration offers, each with its inputs and the ID it has in this environment once it has been added. Use it to find the `toolName` that execute and add-tool take.

### Endpoint

```http
GET /v1/stable/integration/{integration}/schema
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Path parameters

#### `integration`

Required · string

The integration identifier, as `GET /v1/stable/integration` lists it (for example `twilio`).

```json
{
  "type": "string"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

### Responses

#### 200

Returns every tool the integration offers, attached or not, each with its catalog `toolName`, inputs, and `integrationToolID` (null until the tool is added), plus whether the project has credentials stored for the integration.

Schema:

```json
{
  "$ref": "#/components/schemas/StableIntegrationSchemaReadResponse"
}
```

Example:

```json
{
  "connected": true,
  "tools": [
    {
      "toolName": "<IntegrationToolName>",
      "name": "<string>",
      "description": "<string>",
      "integrationToolID": "<string>",
      "inputs": [
        "<StableExecuteInput>"
      ]
    }
  ]
}
```

### Request examples

#### cURL

```bash
curl --request GET \
  --url 'https://realtime-api.voiceflow.com/v1/stable/integration/<integration>/schema?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/integration/<integration>/schema?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer <token>',
  },
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.get(
    'https://realtime-api.voiceflow.com/v1/stable/integration/<integration>/schema?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf integration get-schema --integration <integration> --project-id <projectID> --environment-alias <environmentAlias>
```


## Add integration tool

Adds one of an integration's catalog tools to the environment's draft and returns the `integrationToolID` that the tool create operation attaches. Adding a tool connects nothing, so the integration still has to be connected before the tool can run.

### Endpoint

```http
POST /v1/stable/integration/{integration}/tool
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Path parameters

#### `integration`

Required · string

The integration identifier, as `GET /v1/stable/integration` lists it (for example `twilio`).

```json
{
  "type": "string"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

### Request body

Required

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StableIntegrationAddToolRequest"
      }
    }
  }
}
```

### Responses

#### 200

Returns the `integrationToolID` to attach the tool with, and `created`, which is false when the tool had already been added to this environment and nothing changed.

Schema:

```json
{
  "$ref": "#/components/schemas/StableIntegrationAddToolResponse"
}
```

Example:

```json
{
  "message": "<string>",
  "integrationToolID": "<string>",
  "created": true
}
```

### Request examples

#### cURL

```bash
curl --request POST \
  --url 'https://realtime-api.voiceflow.com/v1/stable/integration/<integration>/tool?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "toolName": "example_dynamic_schema"
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/integration/<integration>/tool?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "toolName": "example_dynamic_schema"
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.post(
    'https://realtime-api.voiceflow.com/v1/stable/integration/<integration>/tool?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "toolName": "example_dynamic_schema"
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf integration add-tool --integration <integration> --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "toolName": "example_dynamic_schema"
}
JSON
```


## Execute integration tool

Runs one tool from an integration once, using the project's stored connection and without starting a conversation. The tool acts on the real connected account, so a tool that writes to an external system changes that system.

### Endpoint

```http
POST /v1/stable/integration/{integration}/execute
```

Server: https://realtime-api.voiceflow.com

### Authentication

```json
[
  {
    "token": []
  }
]
```

`token`:

```json
{
  "scheme": "bearer",
  "bearerFormat": "JWT",
  "type": "http",
  "description": "Voiceflow bearer token"
}
```

### Path parameters

#### `integration`

Required · string

The integration identifier, as `GET /v1/stable/integration` lists it (for example `twilio`).

```json
{
  "type": "string"
}
```

### Query parameters

#### `projectID`

Required · string

The ID of the project to operate on.

```json
{
  "type": "string",
  "description": "The ID of the project to operate on."
}
```

#### `environmentAlias`

Required · string

The alias of the environment to operate on (e.g. `main`).

```json
{
  "type": "string",
  "description": "The alias of the environment to operate on (e.g. `main`)."
}
```

### Request body

Required

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/StableIntegrationExecuteRequest"
      }
    }
  }
}
```

### Responses

#### 200

Returns what the tool returned in `output`, or null when the run failed. Secret values read `[secret]` in the result.

Schema:

```json
{
  "$ref": "#/components/schemas/StableIntegrationExecuteResponse"
}
```

Example:

```json
{
  "success": true,
  "latencyMs": 0,
  "error": "<string>",
  "truncated": true,
  "output": null
}
```

### Request examples

#### cURL

```bash
curl --request POST \
  --url 'https://realtime-api.voiceflow.com/v1/stable/integration/<integration>/execute?projectID=<projectID>&environmentAlias=<environmentAlias>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "toolName": "example_dynamic_schema",
  "inputs": {},
  "extendedInputVariables": {}
}'
```

#### JavaScript

```javascript
const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/integration/<integration>/execute?projectID=<projectID>&environmentAlias=<environmentAlias>', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "toolName": "example_dynamic_schema",
    "inputs": {},
    "extendedInputVariables": {}
  }),
});
const data = await response.json();
```

#### Python

```python
import requests

response = requests.post(
    'https://realtime-api.voiceflow.com/v1/stable/integration/<integration>/execute?projectID=<projectID>&environmentAlias=<environmentAlias>',
    headers={'Authorization': 'Bearer <token>'},
    json={
      "toolName": "example_dynamic_schema",
      "inputs": {},
      "extendedInputVariables": {}
    },
)
data = response.json()
```

#### Voiceflow CLI

```bash
vf integration execute --integration <integration> --project-id <projectID> --environment-alias <environmentAlias> <<'JSON'
{
  "toolName": "example_dynamic_schema",
  "inputs": {},
  "extendedInputVariables": {}
}
JSON
```


## Schema definitions

### CustomHandoffIntegrationCredentialsValue

```json
{
  "type": "object",
  "properties": {
    "baseUrl": {
      "type": "string",
      "format": "uri",
      "description": "Middleware root; we append the fixed paths."
    },
    "authHeaderValue": {
      "type": "string",
      "minLength": 1,
      "description": "Sent verbatim, opaque to us."
    },
    "webhookSecret": {
      "type": "string",
      "minLength": 32,
      "description": "HMAC-SHA256 key for inbound events."
    },
    "authHeaderName": {
      "default": "Authorization",
      "type": "string",
      "minLength": 1,
      "pattern": "^[!#$%&'*+\\-.^_`|~0-9A-Za-z]+$"
    }
  },
  "required": [
    "baseUrl",
    "authHeaderValue",
    "webhookSecret"
  ]
}
```

### DixaIntegrationCredentialsValue

```json
{
  "type": "object",
  "properties": {
    "domain": {
      "description": "Dixa domain.",
      "type": "string"
    },
    "apiKey": {
      "type": "string",
      "description": "Dixa API key."
    },
    "webhookSecretKey": {
      "type": "string",
      "description": "Dixa webhook secret key."
    }
  },
  "required": [
    "apiKey",
    "webhookSecretKey"
  ]
}
```

### GenesysIntegrationCredentialsValue

```json
{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Genesys domain."
    },
    "clientId": {
      "type": "string",
      "description": "Genesys client ID."
    },
    "secretKey": {
      "type": "string",
      "description": "Genesys webhook secret."
    },
    "oauthSecretKey": {
      "type": "string",
      "description": "Genesys OAuth secret key."
    }
  },
  "required": [
    "domain",
    "clientId",
    "secretKey",
    "oauthSecretKey"
  ]
}
```

### IntegrationConnectionType

```json
{
  "type": "string",
  "enum": [
    "app",
    "oauth",
    "api-key"
  ],
  "x-enumNames": [
    "APP",
    "OAUTH",
    "API_KEY"
  ]
}
```

### IntegrationToolName

```json
{
  "type": "string",
  "enum": [
    "example_dynamic_schema",
    "zendesk_find_user",
    "zendesk_find_group",
    "zendesk_find_ticket",
    "zendesk_create_ticket",
    "zendesk_update_ticket",
    "zendesk_add_ticket_comment",
    "zendesk_update_organization",
    "zendesk_find_latest_comment",
    "salesforce_create_lead",
    "salesforce_update_lead",
    "salesforce_create_contact",
    "salesforce_update_contact",
    "salesforce_create_case",
    "salesforce_update_case",
    "salesforce_add_comment_to_case",
    "shopify_get_products",
    "shopify_get_order",
    "shopify_cancel_order",
    "shopify_update_order",
    "google_sheets_create_spreadsheet",
    "google_sheets_update_spreadsheet",
    "google_sheets_read_spreadsheet",
    "google_sheets_append_spreadsheet",
    "google_sheets_read_row",
    "google_gmail_send_email",
    "airtable_create_records",
    "airtable_delete_records",
    "airtable_get_record",
    "airtable_list_records",
    "airtable_update_records",
    "make_run_scenario",
    "twilio_send_sms",
    "hubspot_create_contact",
    "hubspot_create_lead",
    "hubspot_create_ticket",
    "kustomer_find_customer",
    "kustomer_create_customer",
    "kustomer_update_customer",
    "kustomer_find_conversation",
    "kustomer_find_customer_conversations",
    "kustomer_create_conversation",
    "kustomer_update_conversation",
    "kustomer_add_conversation_note",
    "kustomer_add_conversation_tags",
    "kustomer_find_latest_message",
    "kustomer_find_team",
    "kustomer_update_company"
  ],
  "x-enumNames": [
    "EXAMPLE_DYNAMIC_SCHEMA",
    "ZENDESK_FIND_USER",
    "ZENDESK_FIND_GROUP",
    "ZENDESK_FIND_TICKET",
    "ZENDESK_CREATE_TICKET",
    "ZENDESK_UPDATE_TICKET",
    "ZENDESK_ADD_TICKET_COMMENT",
    "ZENDESK_UPDATE_ORGANIZATION",
    "ZENDESK_FIND_LATEST_TICKET_COMMENT",
    "SALESFORCE_CREATE_LEAD",
    "SALESFORCE_UPDATE_LEAD",
    "SALESFORCE_CREATE_CONTACT",
    "SALESFORCE_UPDATE_CONTACT",
    "SALESFORCE_CREATE_CASE",
    "SALESFORCE_UPDATE_CASE",
    "SALESFORCE_ADD_COMMENT_TO_CASE",
    "SHOPIFY_GET_PRODUCTS",
    "SHOPIFY_GET_ORDER",
    "SHOPIFY_CANCEL_ORDER",
    "SHOPIFY_UPDATE_ORDER",
    "GOOGLE_SHEETS_CREATE_SPREADSHEET",
    "GOOGLE_SHEETS_UPDATE_SPREADSHEET",
    "GOOGLE_SHEETS_READ_SPREADSHEET",
    "GOOGLE_SHEETS_APPEND_SPREADSHEET",
    "GOOGLE_SHEETS_READ_ROW",
    "GOOGLE_GMAIL_SEND_EMAIL",
    "AIRTABLE_CREATE_RECORDS",
    "AIRTABLE_DELETE_RECORDS",
    "AIRTABLE_GET_RECORD",
    "AIRTABLE_LIST_RECORDS",
    "AIRTABLE_UPDATE_RECORDS",
    "MAKE_RUN_SCENARIO",
    "TWILIO_SEND_SMS",
    "HUBSPOT_CREATE_CONTACT",
    "HUBSPOT_CREATE_LEAD",
    "HUBSPOT_CREATE_TICKET",
    "KUSTOMER_FIND_CUSTOMER",
    "KUSTOMER_CREATE_CUSTOMER",
    "KUSTOMER_UPDATE_CUSTOMER",
    "KUSTOMER_FIND_CONVERSATION",
    "KUSTOMER_FIND_CUSTOMER_CONVERSATIONS",
    "KUSTOMER_CREATE_CONVERSATION",
    "KUSTOMER_UPDATE_CONVERSATION",
    "KUSTOMER_ADD_CONVERSATION_NOTE",
    "KUSTOMER_ADD_CONVERSATION_TAGS",
    "KUSTOMER_FIND_LATEST_MESSAGE",
    "KUSTOMER_FIND_TEAM",
    "KUSTOMER_UPDATE_COMPANY"
  ]
}
```

### KustomerIntegrationCredentialsValue

```json
{
  "type": "object",
  "properties": {
    "orgName": {
      "type": "string",
      "description": "Kustomer org slug"
    },
    "apiKey": {
      "type": "string",
      "description": "Kustomer org-level Bearer API key."
    },
    "secretKey": {
      "default": "",
      "description": "Kustomer outbound webhook signing secret. Only required for live agent handoff.",
      "type": "string"
    }
  },
  "required": [
    "orgName",
    "apiKey"
  ]
}
```

### ProjectIntegration

```json
{
  "type": "string",
  "enum": [
    "make",
    "zendesk",
    "shopify",
    "airtable",
    "salesforce",
    "hubspot",
    "google_gmail",
    "google_sheets",
    "twilio",
    "ujet",
    "genesys",
    "kustomer",
    "dixa",
    "sunshine",
    "custom_handoff",
    "example",
    "eleven_labs"
  ],
  "x-enumNames": [
    "MAKE",
    "ZENDESK",
    "SHOPIFY",
    "AIRTABLE",
    "SALESFORCE",
    "HUBSPOT",
    "GOOGLE_GMAIL",
    "GOOGLE_SHEETS",
    "TWILIO",
    "UJET",
    "GENESYS",
    "KUSTOMER",
    "DIXA",
    "SUNSHINE",
    "CUSTOM_HANDOFF",
    "EXAMPLE",
    "ELEVEN_LABS"
  ]
}
```

### StableDeleteResponse

```json
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "A human-readable message confirming the deletion."
    }
  },
  "required": [
    "message"
  ]
}
```

### StableExecuteInput

```json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The input name, used as its key in `inputs` when executing."
    },
    "type": {
      "type": "string",
      "description": "The JSON type the value must have, such as `string`, `number` or `boolean`. Always `string` for a function or an API tool, and `any` when an MCP tool does not say."
    },
    "required": {
      "type": "boolean",
      "description": "Whether execute needs a value for this input."
    },
    "description": {
      "nullable": true,
      "description": "What the input holds, as the tool describes it.",
      "type": "string"
    }
  },
  "required": [
    "name",
    "type",
    "required",
    "description"
  ]
}
```

### StableIntegration

```json
{
  "type": "object",
  "properties": {
    "integration": {
      "description": "The integration identifier, used as the path segment when connecting or disconnecting.",
      "allOf": [
        {
          "$ref": "#/components/schemas/ProjectIntegration"
        }
      ],
      "enum": [
        "make",
        "zendesk",
        "shopify",
        "airtable",
        "salesforce",
        "hubspot",
        "google_gmail",
        "google_sheets",
        "twilio",
        "ujet",
        "genesys",
        "kustomer",
        "dixa",
        "sunshine",
        "custom_handoff",
        "example",
        "eleven_labs"
      ],
      "x-enumNames": [
        "MAKE",
        "ZENDESK",
        "SHOPIFY",
        "AIRTABLE",
        "SALESFORCE",
        "HUBSPOT",
        "GOOGLE_GMAIL",
        "GOOGLE_SHEETS",
        "TWILIO",
        "UJET",
        "GENESYS",
        "KUSTOMER",
        "DIXA",
        "SUNSHINE",
        "CUSTOM_HANDOFF",
        "EXAMPLE",
        "ELEVEN_LABS"
      ]
    },
    "name": {
      "type": "string",
      "description": "The human-readable name of the integration."
    },
    "connectionType": {
      "description": "How credentials reach the integration: `oauth` and `app` are browser flows owned by the Voiceflow UI, `api-key` is a credential the caller supplies directly.",
      "allOf": [
        {
          "$ref": "#/components/schemas/IntegrationConnectionType"
        }
      ],
      "enum": [
        "app",
        "oauth",
        "api-key"
      ],
      "x-enumNames": [
        "APP",
        "OAUTH",
        "API_KEY"
      ]
    },
    "connected": {
      "type": "boolean",
      "description": "Whether this project currently has credentials stored for the integration."
    },
    "connectableViaAPI": {
      "type": "boolean",
      "description": "Whether this integration can be connected through this API. False for `oauth` and `app` integrations."
    }
  },
  "required": [
    "integration",
    "name",
    "connectionType",
    "connected",
    "connectableViaAPI"
  ]
}
```

### StableIntegrationAddToolRequest

```json
{
  "type": "object",
  "properties": {
    "toolName": {
      "description": "The catalog tool to add, as get_schema lists it, such as `google_sheets_update_spreadsheet`. It must belong to the integration in the path.",
      "allOf": [
        {
          "$ref": "#/components/schemas/IntegrationToolName"
        }
      ],
      "enum": [
        "example_dynamic_schema",
        "zendesk_find_user",
        "zendesk_find_group",
        "zendesk_find_ticket",
        "zendesk_create_ticket",
        "zendesk_update_ticket",
        "zendesk_add_ticket_comment",
        "zendesk_update_organization",
        "zendesk_find_latest_comment",
        "salesforce_create_lead",
        "salesforce_update_lead",
        "salesforce_create_contact",
        "salesforce_update_contact",
        "salesforce_create_case",
        "salesforce_update_case",
        "salesforce_add_comment_to_case",
        "shopify_get_products",
        "shopify_get_order",
        "shopify_cancel_order",
        "shopify_update_order",
        "google_sheets_create_spreadsheet",
        "google_sheets_update_spreadsheet",
        "google_sheets_read_spreadsheet",
        "google_sheets_append_spreadsheet",
        "google_sheets_read_row",
        "google_gmail_send_email",
        "airtable_create_records",
        "airtable_delete_records",
        "airtable_get_record",
        "airtable_list_records",
        "airtable_update_records",
        "make_run_scenario",
        "twilio_send_sms",
        "hubspot_create_contact",
        "hubspot_create_lead",
        "hubspot_create_ticket",
        "kustomer_find_customer",
        "kustomer_create_customer",
        "kustomer_update_customer",
        "kustomer_find_conversation",
        "kustomer_find_customer_conversations",
        "kustomer_create_conversation",
        "kustomer_update_conversation",
        "kustomer_add_conversation_note",
        "kustomer_add_conversation_tags",
        "kustomer_find_latest_message",
        "kustomer_find_team",
        "kustomer_update_company"
      ],
      "x-enumNames": [
        "EXAMPLE_DYNAMIC_SCHEMA",
        "ZENDESK_FIND_USER",
        "ZENDESK_FIND_GROUP",
        "ZENDESK_FIND_TICKET",
        "ZENDESK_CREATE_TICKET",
        "ZENDESK_UPDATE_TICKET",
        "ZENDESK_ADD_TICKET_COMMENT",
        "ZENDESK_UPDATE_ORGANIZATION",
        "ZENDESK_FIND_LATEST_TICKET_COMMENT",
        "SALESFORCE_CREATE_LEAD",
        "SALESFORCE_UPDATE_LEAD",
        "SALESFORCE_CREATE_CONTACT",
        "SALESFORCE_UPDATE_CONTACT",
        "SALESFORCE_CREATE_CASE",
        "SALESFORCE_UPDATE_CASE",
        "SALESFORCE_ADD_COMMENT_TO_CASE",
        "SHOPIFY_GET_PRODUCTS",
        "SHOPIFY_GET_ORDER",
        "SHOPIFY_CANCEL_ORDER",
        "SHOPIFY_UPDATE_ORDER",
        "GOOGLE_SHEETS_CREATE_SPREADSHEET",
        "GOOGLE_SHEETS_UPDATE_SPREADSHEET",
        "GOOGLE_SHEETS_READ_SPREADSHEET",
        "GOOGLE_SHEETS_APPEND_SPREADSHEET",
        "GOOGLE_SHEETS_READ_ROW",
        "GOOGLE_GMAIL_SEND_EMAIL",
        "AIRTABLE_CREATE_RECORDS",
        "AIRTABLE_DELETE_RECORDS",
        "AIRTABLE_GET_RECORD",
        "AIRTABLE_LIST_RECORDS",
        "AIRTABLE_UPDATE_RECORDS",
        "MAKE_RUN_SCENARIO",
        "TWILIO_SEND_SMS",
        "HUBSPOT_CREATE_CONTACT",
        "HUBSPOT_CREATE_LEAD",
        "HUBSPOT_CREATE_TICKET",
        "KUSTOMER_FIND_CUSTOMER",
        "KUSTOMER_CREATE_CUSTOMER",
        "KUSTOMER_UPDATE_CUSTOMER",
        "KUSTOMER_FIND_CONVERSATION",
        "KUSTOMER_FIND_CUSTOMER_CONVERSATIONS",
        "KUSTOMER_CREATE_CONVERSATION",
        "KUSTOMER_UPDATE_CONVERSATION",
        "KUSTOMER_ADD_CONVERSATION_NOTE",
        "KUSTOMER_ADD_CONVERSATION_TAGS",
        "KUSTOMER_FIND_LATEST_MESSAGE",
        "KUSTOMER_FIND_TEAM",
        "KUSTOMER_UPDATE_COMPANY"
      ]
    }
  },
  "required": [
    "toolName"
  ],
  "additionalProperties": false
}
```

### StableIntegrationAddToolResponse

```json
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "A human-readable message confirming the update."
    },
    "integrationToolID": {
      "type": "string",
      "description": "The ID to attach the tool with, through the tool create operation."
    },
    "created": {
      "type": "boolean",
      "description": "False when the tool was already added to this environment; nothing changed then."
    }
  },
  "required": [
    "message",
    "integrationToolID",
    "created"
  ]
}
```

### StableIntegrationConnectRequest

```json
{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "eleven_labs"
          ],
          "x-enumNames": [
            "ELEVEN_LABS"
          ]
        },
        "credentials": {
          "type": "string"
        }
      },
      "required": [
        "integration",
        "credentials"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "twilio"
          ],
          "x-enumNames": [
            "TWILIO"
          ]
        },
        "credentials": {
          "$ref": "#/components/schemas/TwilioIntegrationAPIKeyValue"
        }
      },
      "required": [
        "integration",
        "credentials"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "ujet"
          ],
          "x-enumNames": [
            "UJET"
          ]
        },
        "credentials": {
          "$ref": "#/components/schemas/UjetIntegrationCredentialsValue"
        }
      },
      "required": [
        "integration",
        "credentials"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "genesys"
          ],
          "x-enumNames": [
            "GENESYS"
          ]
        },
        "credentials": {
          "$ref": "#/components/schemas/GenesysIntegrationCredentialsValue"
        }
      },
      "required": [
        "integration",
        "credentials"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "kustomer"
          ],
          "x-enumNames": [
            "KUSTOMER"
          ]
        },
        "credentials": {
          "$ref": "#/components/schemas/KustomerIntegrationCredentialsValue"
        }
      },
      "required": [
        "integration",
        "credentials"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "dixa"
          ],
          "x-enumNames": [
            "DIXA"
          ]
        },
        "credentials": {
          "$ref": "#/components/schemas/DixaIntegrationCredentialsValue"
        }
      },
      "required": [
        "integration",
        "credentials"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "sunshine"
          ],
          "x-enumNames": [
            "SUNSHINE"
          ]
        },
        "credentials": {
          "$ref": "#/components/schemas/SunshineIntegrationCredentialsValue"
        }
      },
      "required": [
        "integration",
        "credentials"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "custom_handoff"
          ],
          "x-enumNames": [
            "CUSTOM_HANDOFF"
          ]
        },
        "credentials": {
          "$ref": "#/components/schemas/CustomHandoffIntegrationCredentialsValue"
        }
      },
      "required": [
        "integration",
        "credentials"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "zendesk"
          ],
          "x-enumNames": [
            "ZENDESK"
          ]
        }
      },
      "required": [
        "integration"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "salesforce"
          ],
          "x-enumNames": [
            "SALESFORCE"
          ]
        }
      },
      "required": [
        "integration"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "shopify"
          ],
          "x-enumNames": [
            "SHOPIFY"
          ]
        }
      },
      "required": [
        "integration"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "google_sheets"
          ],
          "x-enumNames": [
            "GOOGLE_SHEETS"
          ]
        }
      },
      "required": [
        "integration"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "google_gmail"
          ],
          "x-enumNames": [
            "GOOGLE_GMAIL"
          ]
        }
      },
      "required": [
        "integration"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "airtable"
          ],
          "x-enumNames": [
            "AIRTABLE"
          ]
        }
      },
      "required": [
        "integration"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "make"
          ],
          "x-enumNames": [
            "MAKE"
          ]
        }
      },
      "required": [
        "integration"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "hubspot"
          ],
          "x-enumNames": [
            "HUBSPOT"
          ]
        }
      },
      "required": [
        "integration"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "integration": {
          "type": "string",
          "enum": [
            "example"
          ],
          "x-enumNames": [
            "EXAMPLE"
          ]
        }
      },
      "required": [
        "integration"
      ],
      "additionalProperties": false
    }
  ]
}
```

### StableIntegrationExecuteExtendedInput

```json
{
  "type": "object",
  "properties": {
    "metadata": {
      "description": "The provider IDs behind each field name, such as a Zendesk custom field ID and its option IDs.",
      "type": "object",
      "additionalProperties": {}
    },
    "draft": {
      "description": "The same metadata, fetched from the Draft connection.",
      "allOf": [
        {
          "$ref": "#/components/schemas/StableIntegrationExecuteExtendedInputSlot"
        }
      ]
    }
  }
}
```

### StableIntegrationExecuteExtendedInputSlot

```json
{
  "type": "object",
  "properties": {
    "metadata": {
      "description": "The provider IDs behind each field name, such as a Zendesk custom field ID and its option IDs.",
      "type": "object",
      "additionalProperties": {}
    }
  }
}
```

### StableIntegrationExecuteRequest

```json
{
  "type": "object",
  "properties": {
    "toolName": {
      "description": "The catalog tool to run, as get_schema lists it, such as `zendesk_find_ticket`. It must belong to the integration in the path.",
      "allOf": [
        {
          "$ref": "#/components/schemas/IntegrationToolName"
        }
      ],
      "enum": [
        "example_dynamic_schema",
        "zendesk_find_user",
        "zendesk_find_group",
        "zendesk_find_ticket",
        "zendesk_create_ticket",
        "zendesk_update_ticket",
        "zendesk_add_ticket_comment",
        "zendesk_update_organization",
        "zendesk_find_latest_comment",
        "salesforce_create_lead",
        "salesforce_update_lead",
        "salesforce_create_contact",
        "salesforce_update_contact",
        "salesforce_create_case",
        "salesforce_update_case",
        "salesforce_add_comment_to_case",
        "shopify_get_products",
        "shopify_get_order",
        "shopify_cancel_order",
        "shopify_update_order",
        "google_sheets_create_spreadsheet",
        "google_sheets_update_spreadsheet",
        "google_sheets_read_spreadsheet",
        "google_sheets_append_spreadsheet",
        "google_sheets_read_row",
        "google_gmail_send_email",
        "airtable_create_records",
        "airtable_delete_records",
        "airtable_get_record",
        "airtable_list_records",
        "airtable_update_records",
        "make_run_scenario",
        "twilio_send_sms",
        "hubspot_create_contact",
        "hubspot_create_lead",
        "hubspot_create_ticket",
        "kustomer_find_customer",
        "kustomer_create_customer",
        "kustomer_update_customer",
        "kustomer_find_conversation",
        "kustomer_find_customer_conversations",
        "kustomer_create_conversation",
        "kustomer_update_conversation",
        "kustomer_add_conversation_note",
        "kustomer_add_conversation_tags",
        "kustomer_find_latest_message",
        "kustomer_find_team",
        "kustomer_update_company"
      ],
      "x-enumNames": [
        "EXAMPLE_DYNAMIC_SCHEMA",
        "ZENDESK_FIND_USER",
        "ZENDESK_FIND_GROUP",
        "ZENDESK_FIND_TICKET",
        "ZENDESK_CREATE_TICKET",
        "ZENDESK_UPDATE_TICKET",
        "ZENDESK_ADD_TICKET_COMMENT",
        "ZENDESK_UPDATE_ORGANIZATION",
        "ZENDESK_FIND_LATEST_TICKET_COMMENT",
        "SALESFORCE_CREATE_LEAD",
        "SALESFORCE_UPDATE_LEAD",
        "SALESFORCE_CREATE_CONTACT",
        "SALESFORCE_UPDATE_CONTACT",
        "SALESFORCE_CREATE_CASE",
        "SALESFORCE_UPDATE_CASE",
        "SALESFORCE_ADD_COMMENT_TO_CASE",
        "SHOPIFY_GET_PRODUCTS",
        "SHOPIFY_GET_ORDER",
        "SHOPIFY_CANCEL_ORDER",
        "SHOPIFY_UPDATE_ORDER",
        "GOOGLE_SHEETS_CREATE_SPREADSHEET",
        "GOOGLE_SHEETS_UPDATE_SPREADSHEET",
        "GOOGLE_SHEETS_READ_SPREADSHEET",
        "GOOGLE_SHEETS_APPEND_SPREADSHEET",
        "GOOGLE_SHEETS_READ_ROW",
        "GOOGLE_GMAIL_SEND_EMAIL",
        "AIRTABLE_CREATE_RECORDS",
        "AIRTABLE_DELETE_RECORDS",
        "AIRTABLE_GET_RECORD",
        "AIRTABLE_LIST_RECORDS",
        "AIRTABLE_UPDATE_RECORDS",
        "MAKE_RUN_SCENARIO",
        "TWILIO_SEND_SMS",
        "HUBSPOT_CREATE_CONTACT",
        "HUBSPOT_CREATE_LEAD",
        "HUBSPOT_CREATE_TICKET",
        "KUSTOMER_FIND_CUSTOMER",
        "KUSTOMER_CREATE_CUSTOMER",
        "KUSTOMER_UPDATE_CUSTOMER",
        "KUSTOMER_FIND_CONVERSATION",
        "KUSTOMER_FIND_CUSTOMER_CONVERSATIONS",
        "KUSTOMER_CREATE_CONVERSATION",
        "KUSTOMER_UPDATE_CONVERSATION",
        "KUSTOMER_ADD_CONVERSATION_NOTE",
        "KUSTOMER_ADD_CONVERSATION_TAGS",
        "KUSTOMER_FIND_LATEST_MESSAGE",
        "KUSTOMER_FIND_TEAM",
        "KUSTOMER_UPDATE_COMPANY"
      ]
    },
    "inputs": {
      "default": {},
      "description": "The tool's inputs, keyed by input name and typed as get_schema says. A top-level string value follows the ExecuteInputString rules, so {secret_name} inserts a project secret. Secrets work only at the top level: inside a nested object or array, {secret_name} is sent as written and no secret is filled in.",
      "type": "object",
      "additionalProperties": {}
    },
    "extendedInputVariables": {
      "description": "Provider metadata the tool editor stored for this tool, such as Zendesk custom field IDs. Omit it unless you are replaying an editor run.",
      "nullable": true,
      "type": "object",
      "additionalProperties": {
        "$ref": "#/components/schemas/StableIntegrationExecuteExtendedInput"
      }
    }
  },
  "required": [
    "toolName"
  ],
  "additionalProperties": false
}
```

### StableIntegrationExecuteResponse

```json
{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "description": "Whether the tool ran and reported no error."
    },
    "latencyMs": {
      "type": "number",
      "description": "How long the run took, in milliseconds, measured by this API around the call."
    },
    "error": {
      "nullable": true,
      "description": "Why the run failed when `success` is false, otherwise null. Secret values read `[secret]`.",
      "type": "string"
    },
    "truncated": {
      "type": "boolean",
      "description": "Whether a returned payload was over 64 KB and was cut to its first 64 KB of JSON text, which then arrives as a string."
    },
    "output": {
      "description": "What the integration tool returned, or null when the run failed. Secret values read `[secret]`."
    }
  },
  "required": [
    "success",
    "latencyMs",
    "error",
    "truncated",
    "output"
  ]
}
```

### StableIntegrationListResponse

```json
{
  "type": "object",
  "properties": {
    "integrations": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableIntegration"
      }
    }
  },
  "required": [
    "integrations"
  ]
}
```

### StableIntegrationSchemaReadResponse

```json
{
  "type": "object",
  "properties": {
    "connected": {
      "type": "boolean",
      "description": "Whether the project has credentials stored for the integration, as the integration list reports it. A connection saved only in the draft may read false and still run."
    },
    "tools": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableIntegrationSchemaTool"
      },
      "description": "Every tool the integration offers, attached or not. Empty for an integration with no tools, such as ElevenLabs."
    }
  },
  "required": [
    "connected",
    "tools"
  ]
}
```

### StableIntegrationSchemaTool

```json
{
  "type": "object",
  "properties": {
    "toolName": {
      "description": "The catalog name to pass as `toolName` when executing.",
      "allOf": [
        {
          "$ref": "#/components/schemas/IntegrationToolName"
        }
      ],
      "enum": [
        "example_dynamic_schema",
        "zendesk_find_user",
        "zendesk_find_group",
        "zendesk_find_ticket",
        "zendesk_create_ticket",
        "zendesk_update_ticket",
        "zendesk_add_ticket_comment",
        "zendesk_update_organization",
        "zendesk_find_latest_comment",
        "salesforce_create_lead",
        "salesforce_update_lead",
        "salesforce_create_contact",
        "salesforce_update_contact",
        "salesforce_create_case",
        "salesforce_update_case",
        "salesforce_add_comment_to_case",
        "shopify_get_products",
        "shopify_get_order",
        "shopify_cancel_order",
        "shopify_update_order",
        "google_sheets_create_spreadsheet",
        "google_sheets_update_spreadsheet",
        "google_sheets_read_spreadsheet",
        "google_sheets_append_spreadsheet",
        "google_sheets_read_row",
        "google_gmail_send_email",
        "airtable_create_records",
        "airtable_delete_records",
        "airtable_get_record",
        "airtable_list_records",
        "airtable_update_records",
        "make_run_scenario",
        "twilio_send_sms",
        "hubspot_create_contact",
        "hubspot_create_lead",
        "hubspot_create_ticket",
        "kustomer_find_customer",
        "kustomer_create_customer",
        "kustomer_update_customer",
        "kustomer_find_conversation",
        "kustomer_find_customer_conversations",
        "kustomer_create_conversation",
        "kustomer_update_conversation",
        "kustomer_add_conversation_note",
        "kustomer_add_conversation_tags",
        "kustomer_find_latest_message",
        "kustomer_find_team",
        "kustomer_update_company"
      ],
      "x-enumNames": [
        "EXAMPLE_DYNAMIC_SCHEMA",
        "ZENDESK_FIND_USER",
        "ZENDESK_FIND_GROUP",
        "ZENDESK_FIND_TICKET",
        "ZENDESK_CREATE_TICKET",
        "ZENDESK_UPDATE_TICKET",
        "ZENDESK_ADD_TICKET_COMMENT",
        "ZENDESK_UPDATE_ORGANIZATION",
        "ZENDESK_FIND_LATEST_TICKET_COMMENT",
        "SALESFORCE_CREATE_LEAD",
        "SALESFORCE_UPDATE_LEAD",
        "SALESFORCE_CREATE_CONTACT",
        "SALESFORCE_UPDATE_CONTACT",
        "SALESFORCE_CREATE_CASE",
        "SALESFORCE_UPDATE_CASE",
        "SALESFORCE_ADD_COMMENT_TO_CASE",
        "SHOPIFY_GET_PRODUCTS",
        "SHOPIFY_GET_ORDER",
        "SHOPIFY_CANCEL_ORDER",
        "SHOPIFY_UPDATE_ORDER",
        "GOOGLE_SHEETS_CREATE_SPREADSHEET",
        "GOOGLE_SHEETS_UPDATE_SPREADSHEET",
        "GOOGLE_SHEETS_READ_SPREADSHEET",
        "GOOGLE_SHEETS_APPEND_SPREADSHEET",
        "GOOGLE_SHEETS_READ_ROW",
        "GOOGLE_GMAIL_SEND_EMAIL",
        "AIRTABLE_CREATE_RECORDS",
        "AIRTABLE_DELETE_RECORDS",
        "AIRTABLE_GET_RECORD",
        "AIRTABLE_LIST_RECORDS",
        "AIRTABLE_UPDATE_RECORDS",
        "MAKE_RUN_SCENARIO",
        "TWILIO_SEND_SMS",
        "HUBSPOT_CREATE_CONTACT",
        "HUBSPOT_CREATE_LEAD",
        "HUBSPOT_CREATE_TICKET",
        "KUSTOMER_FIND_CUSTOMER",
        "KUSTOMER_CREATE_CUSTOMER",
        "KUSTOMER_UPDATE_CUSTOMER",
        "KUSTOMER_FIND_CONVERSATION",
        "KUSTOMER_FIND_CUSTOMER_CONVERSATIONS",
        "KUSTOMER_CREATE_CONVERSATION",
        "KUSTOMER_UPDATE_CONVERSATION",
        "KUSTOMER_ADD_CONVERSATION_NOTE",
        "KUSTOMER_ADD_CONVERSATION_TAGS",
        "KUSTOMER_FIND_LATEST_MESSAGE",
        "KUSTOMER_FIND_TEAM",
        "KUSTOMER_UPDATE_COMPANY"
      ]
    },
    "name": {
      "type": "string",
      "description": "The human-readable name of the tool."
    },
    "description": {
      "type": "string",
      "description": "What the tool does, from the catalog, and which optional inputs a run needs at least one of."
    },
    "integrationToolID": {
      "nullable": true,
      "description": "The ID attachments use for this tool in this environment, or null when the tool has not been added to it yet.",
      "type": "string"
    },
    "inputs": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/StableExecuteInput"
      },
      "description": "The inputs execute takes for this tool."
    }
  },
  "required": [
    "toolName",
    "name",
    "description",
    "integrationToolID",
    "inputs"
  ]
}
```

### StableUpdateResponse

```json
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "description": "A human-readable message confirming the update."
    }
  },
  "required": [
    "message"
  ]
}
```

### SunshineIntegrationCredentialsValue

```json
{
  "type": "object",
  "properties": {
    "subdomain": {
      "type": "string",
      "description": "Zendesk subdomain, base of the Sunshine Conversations API."
    },
    "appId": {
      "type": "string",
      "description": "Sunshine Conversations app ID."
    },
    "keyId": {
      "type": "string",
      "description": "Sunshine API key ID, the Basic auth username."
    },
    "keySecret": {
      "type": "string",
      "description": "Sunshine API key secret, the Basic auth password."
    },
    "webhookSecret": {
      "type": "string",
      "description": "Sunshine webhook secret."
    }
  },
  "required": [
    "subdomain",
    "appId",
    "keyId",
    "keySecret",
    "webhookSecret"
  ]
}
```

### TwilioIntegrationAPIKeyValue

```json
{
  "type": "object",
  "properties": {
    "apiKeySid": {
      "type": "string",
      "description": "Sid associated with the API key."
    },
    "apiKeySecret": {
      "type": "string",
      "description": "Twilio API key secret value."
    },
    "accountSid": {
      "type": "string",
      "description": "Sid associated with the Twilio account."
    }
  },
  "required": [
    "apiKeySid",
    "apiKeySecret",
    "accountSid"
  ]
}
```

### UjetIntegrationCredentialsValue

```json
{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "UJET domain."
    },
    "subdomain": {
      "type": "string",
      "description": "UJET subdomain."
    },
    "apiKey": {
      "type": "string",
      "description": "UJET API key."
    },
    "secretKey": {
      "type": "string",
      "description": "UJET secret key."
    }
  },
  "required": [
    "domain",
    "subdomain",
    "apiKey",
    "secretKey"
  ]
}
```
