Execute an integration action during a call

POST

/api/integrations/execute

Executes a provider action immediately through a tenant connection. Typically called by the voice agent mid-call to perform a real-time operation (e.g. look up or create a record).

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Execution result. Shape depends on the action; includes a success flag and a result or error.

Bodyapplication/json

🟠400

🔴500

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/integrations/execute' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "action_id": "52d6fa12-2c88-46da-984a-4cc821c7837a",
    "connection_id": "d3547de1-d1f2-4344-b4c2-17169b7526f9",
    "tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",
    "params": {},
    "context": {}
}'

Response Example

200 - Example 1

{
    "success": true,
    "result": {
        "id": "rec_123",
        "status": "created"
    }
}

Modified at 2026-07-08 19:01:40

Remove an integration from an agent

Dispatch end-of-call integrations