Create a customer activity

post

Create a new customer activity. Accepts all activity types in the format returned by the GET endpoint (without id, agentId, customerId, createdAt, updatedAt fields). The createdBy field is optional and defaults to the agent user (Sara) if not provided. When provided, only role and uid are required; other user fields will be resolved automatically from the corresponding entity.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer {apikey}

Path parameters

agentIdstringRequired

The ID of the agent.

customerIdstringRequired

The ID of the customer.

Body

application/json

or

Responses

201

Activity created successfully

application/json

400

Bad Request

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Validation Error

application/json

500

Internal Server Error

application/json

post

/v1/agents/{agentId}/customers/{customerId}/activity

HTTPcURLJavaScriptPython

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

{
  "type": "message-sent",
  "content": {
    "channel": "sms",
    "text": "Thank you for contacting us!"
  },
  "createdBy": {
    "role": "user",
    "uid": "user123"
  }
}

Message sent activityEmail sent activity

{
  "id": "text",
  "type": "text",
  "agentId": "text",
  "customerId": "text",
  "content": {},
  "createdBy": {},
  "createdAt": "2026-01-31T08:14:43.730Z",
  "updatedAt": "2026-01-31T08:14:43.730Z"
}