Create an Agent

​

Request

curl -X POST "https://api.interchange.io/api/v2/agents" \
  -H "Authorization: Bearer $INTERACTIVE_USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "displayName": "Acme Signal Agent",
    "role": "SIGNAL",
    "salesMode": null,
    "operator": { "kind": "NEW", "displayName": "Acme" },
    "idempotencyKey": "20000000-0000-4000-8000-000000000003"
  }'

​

Parameters

​

Response

{
  "agentId": "20000000-0000-4000-8000-000000000001",
  "href": "/42/agents/20000000-0000-4000-8000-000000000001",
  "created": true
}

​

Errors

• 400 VALIDATION_ERROR — the request is malformed, a name is empty, the role and sales mode are incompatible, or the operator union is invalid.
• 403 ACCESS_DENIED — the caller is not a directly authenticated organization account admin.
• 404 NOT_FOUND — Organization Agents is unavailable to the caller’s enrolled organization, or the requested existing operator is not owned and claimed.
• 409 CONFLICT — the idempotency key was previously used with different input. A duplicate active NEW operator name in your organization also returns this conflict; select the existing claimed operator instead.

​

MCP tools