Add tool/webhook to agent

POST

/api/agents/{agentId}/tools

Add a custom tool that calls a webhook (e.g., Make.com) during conversation. Agent can invoke this based on user request.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

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

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢201Success

application/json

Tool added successfully

Body

Request Example

Shell

JavaScript

Java

Swift

cURL

Make.com Webhook ExampleWeather API Example

curl --location --request POST 'https://snakk-backend-production.up.railway.app/api/agents//tools' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "lookupCustomer",
    "display_name": "Customer Lookup",
    "description": "Hent kundeinformasjon fra CRM",
    "type": "webhook",
    "webhook_url": "https://hook.eu2.make.com/abc123",
    "webhook_method": "POST",
    "parameters": {
        "customerId": {
            "type": "string",
            "description": "Kunde ID eller telefonnummer"
        }
    },
    "enabled": true
}'

Response Example

{
    "tool": {
        "id": "tool-uuid",
        "agent_id": "agent-uuid",
        "name": "checkWeather",
        "webhook_url": "https://hook.eu2.make.com/xxx",
        "enabled": true
    }
}

Modified at 2025-11-30 23:12:05

List tools/webhooks for agent

Start outbound call from database agent