Errors
Voxity uses conventional HTTP response codes to indicate the success or failure of an API request. Some errors that could be handled programmatically include an error code (see below) that briefly explains the error reported.
Errors Codes
MISSING_AUTHORIZATION_HEADER
Missing or malformed Authorization header.
AGENT_PHONE_NUMBER_NOT_FOUND
The agent does not have a phone number configured.
CUSTOMER_PHONE_NUMBER_NOT_FOUND
The customer does not have a phone number configured.
INVALID_WEBHOOK
The webhook endpoint must be a valid URL and must include at least one event.
INVALID_RESPONDER_INPUT
The provided data does not match the expected JSON input schema.
INVALID_API_KEY
The provided key is invalid.
SMS_MODULE_NOT_ACTIVATED
The SMS module is not activated for the agent.
AGENT_NOT_FOUND
Agent not found or missing.
CUSTOMER_NOT_FOUND
Customer not found or missing.
OPPORTUNITY_NOT_FOUND
Opportunity not found or missing.
PIPELINE_NOT_FOUND
Pipeline not found or missing.
WEBHOOK_NOT_FOUND
Webhook not found or missing.
RESPONDER_NOT_FOUND
LLM Responder not found or missing.
PHONE_NUMBER_IN_USE
An existing customer is already linked to the provided phone number.
INVALID_WEBHOOK
There is already a webhook with the same endpoint and events.
OPPORTUNITY_NOT_FOUND
Opportunity not found or missing.
TASK_NOT_FOUND
Task not found or missing.
CUSTOMER_NOT_FOUND
Customer not found or missing.
PIPELINE_NOT_FOUND
Pipeline not found or missing.
STAGE_NOT_FOUND
Pipeline stage not found or missing.
USER_NOT_FOUND
User not found or missing.
VOIP_PHONE_UPDATE_NA
Updating the phone number is not allowed for VoIP customers.
MISSING_REQUIRED_PIPELINE
The pipelineId is required and cannot be omitted.
INVALID_OPPORTUNITY_OWNER
User must be an active team member.
Last updated