Create an Agent

curl --request POST \
  --url https://api.getarbol.com/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Asistente de ventas",
  "kind": "voice",
  "language": "es"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'Asistente de ventas', kind: 'voice', language: 'es'})
};

fetch('https://api.getarbol.com/v1/agents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.getarbol.com/v1/agents"

payload = {
    "name": "Asistente de ventas",
    "kind": "voice",
    "language": "es"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "createdAt": "2026-08-29T14:30:00Z",
  "description": "<string>",
  "id": "agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31",
  "kind": "voice",
  "language": "<string>",
  "name": "Asistente de ventas",
  "prompt": "<string>",
  "status": "active",
  "supportedChannelKinds": [
    "voice"
  ],
  "timezone": "America/Bogota",
  "updatedAt": "2026-08-29T14:30:00Z",
  "isRunnable": true,
  "knowledgeDocumentIds": [
    "agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31"
  ],
  "profiles": [
    {
      "enabled": true,
      "greeting": "<string>",
      "language": "<string>",
      "channelKind": "voice",
      "settings": {
        "availableLanguages": [
          "<string>"
        ],
        "conversationalBehavior": {
          "backgroundSound": {
            "crossfadeLoop": true,
            "presetId": "office1",
            "volume": 0.6
          },
          "backgroundVoiceDetection": false,
          "expressiveMode": false,
          "interruptionIgnoreTerms": [],
          "keywords": [],
          "maxDurationMessage": "<string>",
          "maxDurationSeconds": 600,
          "mergeDefaultIgnoreTerms": false,
          "retranscribeOnTurnTimeout": false,
          "silenceEndCallTimeoutSeconds": 20,
          "speculativeTurn": false,
          "spellingPatience": "auto",
          "transcribeOnDisabledInterruptions": false,
          "turnEagerness": "normal",
          "turnModel": "turn_v2",
          "turnTimeoutSeconds": 7
        },
        "disableFirstMessageInterruptions": true,
        "greetingTranslations": [
          {
            "language": "<string>",
            "text": "<string>"
          }
        ],
        "humanTransfers": [
          {
            "condition": "<string>",
            "phoneNumber": "+573001234567",
            "transferType": "conference"
          }
        ],
        "intelligence": {
          "backupLlm": {
            "mode": "default",
            "order": []
          },
          "cascadeTimeoutSeconds": 4,
          "llm": "gpt-5.4",
          "maxTokens": -1,
          "parallelToolCalls": false,
          "reasoningEffort": "none",
          "reasoningSummary": false,
          "softTimeout": {
            "enabled": false,
            "message": "",
            "seconds": 3
          },
          "temperature": 0.7
        },
        "toolConfigs": [
          {
            "config": {
              "endCallDescription": "<string>",
              "endCallReasons": [
                "farewell"
              ]
            },
            "isEnabled": true,
            "type": "END_CALL"
          }
        ],
        "voiceConfigs": [
          {
            "language": "<string>",
            "settings": {
              "similarity": 0.8,
              "speed": 1,
              "stability": 0.5
            },
            "voiceId": "<string>",
            "label": "<string>"
          }
        ]
      },
      "id": "agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31",
      "runtimeStatus": "active"
    }
  ],
  "toolAccess": {
    "entries": [
      {
        "connectedAccountId": "agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31",
        "tools": [
          {
            "approval": "confirmationRequired",
            "key": "google-calendar.create-event"
          }
        ]
      }
    ],
    "revision": 4503599627370495
  }
}

{
  "defined": true,
  "inferable": true,
  "code": "BAD_REQUEST",
  "status": 400,
  "message": "<string>",
  "data": {
    "issues": [
      {
        "message": "<string>",
        "path": [
          "<string>"
        ]
      }
    ],
    "truncated": true
  }
}

{
  "defined": true,
  "inferable": true,
  "code": "UNAUTHORIZED",
  "status": 401,
  "message": "<string>",
  "data": "<unknown>"
}

{
  "defined": true,
  "inferable": true,
  "code": "FORBIDDEN",
  "status": 403,
  "message": "<string>",
  "data": {
    "missingPermissions": [
      "agents:read"
    ]
  }
}

{
  "code": "PAYLOAD_TOO_LARGE",
  "defined": false,
  "inferable": false,
  "message": "<string>",
  "data": "<unknown>"
}

{
  "code": "UNSUPPORTED_MEDIA_TYPE",
  "defined": false,
  "inferable": false,
  "message": "<string>",
  "data": "<unknown>"
}

{
  "defined": true,
  "inferable": true,
  "code": "UNPROCESSABLE_CONTENT",
  "status": 422,
  "message": "<string>",
  "data": "<unknown>"
}

{
  "defined": true,
  "inferable": true,
  "code": "TOO_MANY_REQUESTS",
  "status": 429,
  "message": "<string>",
  "data": {
    "retryAfterSeconds": 123
  }
}

{
  "defined": true,
  "inferable": true,
  "code": "SERVICE_UNAVAILABLE",
  "status": 503,
  "message": "<string>",
  "data": "<unknown>"
}