Integrations

Create an integration

Connect a platform account to Ollive.

POSThttps://api.ollive.ai/api/integrations/create/v1

How it works

Ollive checks your keys with the platform before saving anything. If the platform rejects them, nothing is saved and you get a 422.

To see which type values and keys you can use, call List integration types. Once connected, Ollive reads the agents on that account, and List assets shows them.

Authorization

Authorizationheaderrequired
Your API key, after the word Bearer, like this: Bearer sk-…. Create a key.

Request body

application/json

typestringrequired
The platform type, from List integration types. For example, RETELL.
namestringup to 255 characters
A name for this connection. Defaults to the platform’s name. Must be unique in your account.
keysobject
The keys the platform needs, as name and value pairs. Any URL must be a public https:// address.

Response

Connected. Secret keys are never returned, only whether they are set.

idstring (uuid)required
The integration’s ID.
typestringrequired
The platform type, such as RETELL.
kindstringrequired
What kind of platform it is.
agent_platformagent_observabilityalert_and_workflow
namestringrequired
The name you gave it.
keysobject[]required
The keys saved on this integration. Secret values are never shown, only whether they are set.
- namestringrequired
  The key’s name.
- is_secretbooleanrequired
  Whether the value is secret.
- is_setbooleanrequired
  Whether a value is saved.
- valuestringrequired
  The saved value. Always empty for secret keys.
created_atstring (date-time)required
When it was connected.
updated_atstring (date-time)required
When it was last changed.
last_synced_atstring (date-time)
When Ollive last read the agents on this platform. Missing until the first read.

← List integrations Update an integration →

curl -X POST "https://api.ollive.ai/api/integrations/create/v1" \  -H "Authorization: Bearer $OLLIVE_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "type": "RETELL",    "name": "Retell production",    "keys": {      "api_key": "key_••••••••"    }  }'

Response

{  "id": "8f14e45f-ceea-4b2a-9c1e-2a6f0e3d7b51",  "type": "RETELL",  "kind": "agent_platform",  "name": "Retell production",  "keys": [    {      "name": "api_key",      "is_secret": true,      "is_set": true,      "value": ""    }  ],  "created_at": "2026-10-02T14:21:07Z",  "updated_at": "2026-10-02T14:21:07Z"}

{  "error": {    "code": "unknown_integration_type",    "message": "Unknown integration type 'RETEL'. POST /api/integration-types/query/v1 lists them.",    "param": "type",    "request_id": "4b1f0c9e2d7a48b6a3e5f19c0d8b7a26"  }}

{  "error": {    "code": "authentication_failed",    "message": "Invalid API key.",    "param": "",    "request_id": "4b1f0c9e2d7a48b6a3e5f19c0d8b7a26"  }}

{  "error": {    "code": "duplicate_name",    "message": "An integration with this name already exists for this account.",    "param": "name",    "request_id": "4b1f0c9e2d7a48b6a3e5f19c0d8b7a26"  }}

{  "error": {    "code": "connection_test_failed",    "message": "The provider rejected these keys.",    "param": "keys",    "request_id": "4b1f0c9e2d7a48b6a3e5f19c0d8b7a26"  }}