Create a TODO

post

Create a new todo for an agent.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer {apikey}

Path parameters

agentIdstringRequired

Body

application/json

typestring · enumRequired

Type of todo (currently only 'opportunity' is supported)

Possible values:

titlestring · min: 1Required

descriptionstring · nullableOptional

statusstring · enumRequiredPossible values:

prioritystring · enum · nullableOptionalPossible values:

dueDatestring · date-time · nullableOptional

opportunityIdstringRequired

Required for opportunity type todos

pipelineIdstringRequired

Required for opportunity type todos

stageIdstringRequired

Required for opportunity type todos

Responses

201

Todo created successfully

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Entity - Validation error

application/json

500

Internal Server Error

application/json

post

/v1/agents/{agentId}/todos

HTTPcURLJavaScriptPython

POST /v1/agents/{agentId}/todos HTTP/1.1
Host: api.voxity.ai
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 411

{
  "type": "opportunity",
  "title": "text",
  "description": "text",
  "status": "pending",
  "priority": "low",
  "assignedTo": {
    "uid": "text",
    "displayName": "text",
    "firstName": "text",
    "lastName": "text",
    "alias": "text",
    "role": "agent",
    "email": "text",
    "photoURL": "text",
    "phoneNumber": "text"
  },
  "dueDate": "2026-04-02T08:31:06.943Z",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "opportunityId": "text",
  "pipelineId": "text",
  "stageId": "text"
}

{
  "id": "text",
  "type": "opportunity",
  "title": "text",
  "description": "text",
  "status": "pending",
  "priority": "low",
  "createdBy": {
    "uid": "text",
    "displayName": "text",
    "email": "text"
  },
  "updatedBy": {
    "uid": "text",
    "displayName": "text",
    "email": "text"
  },
  "assignedTo": {
    "uid": "text",
    "displayName": "text",
    "firstName": "text",
    "lastName": "text",
    "alias": "text",
    "role": "agent",
    "email": "text",
    "photoURL": "text",
    "phoneNumber": "text"
  },
  "dueDate": "2026-04-02T08:31:06.943Z",
  "metadata": {},
  "opportunityId": "text",
  "pipelineId": "text",
  "stageId": "text",
  "createdAt": "2026-04-02T08:31:06.943Z",
  "updatedAt": "2026-04-02T08:31:06.943Z"
}