Errors

SuprSend uses standard HTTP response codes to indicate the success or failure of your API requests. This page covers common error codes and how to handle them.

Success Codes

Code	Description
`200`	OK - Request succeeded
`201`	Created - Resource was successfully created
`204`	No Content - Request succeeded but no content returned

Error Codes

Code	Description
`400`	Bad Request - Invalid request syntax or parameters
`401`	Unauthorized - Authentication required or failed
`404`	Not Found - Resource not found
`5xx`	Internal Server Error - Unexpected server error

Error Response Format

All error responses follow a consistent format:

{
  "code": 400,
  "error_code": "validation_error",
  "type": "ValidationError",
  "message": "Invalid request parameters",
  "detail": "The 'name' field is required"
}

Field	Type	Description
`code`	integer	HTTP status code
`error_code`	string	Machine-readable error identifier
`type`	string	Error type classification
`message`	string	Human-readable error message
`detail`	string	Additional error details (optional)

Common Error Codes and their solutions

401 Unauthorized - `authentication_failed`

Causes:

Missing or invalid service token
Expired service token
Using environment API key instead of service token

Correct Syntax to authorize Management API:

# Ensure you're using a valid service token
curl -H "Authorization: ServiceToken YOUR_SERVICE_TOKEN" \
     https://management-api.suprsend.com/v1/workflows

400 Bad Request - `validation_error`

Common Causes:

Missing required fields
Invalid field formats
Invalid enum values

Example:

{
  "code": 400,
  "error_code": "validation_error",
  "type": "ValidationError",
  "message": "Invalid request parameters",
  "detail": "The 'name' field is required and cannot be empty"
}

404 Not Found

Common Causes:

Given entity in the request is not found

Example:

{
  "code": 404,
  "error_code": "not_found",
  "type": "NotFound",
  "message": "Workflow not found",
  "detail": "Workflow with slug 'welcome-sequence' does not exist"
}

API Reference

WORKSPACE & AUTH KEYS

WORKFLOWS

SCHEMAS

EVENTS

CATEGORIES

TRANSLATIONS

TEMPLATES

Success Codes

Error Codes

Error Response Format

Common Error Codes and their solutions

401 Unauthorized - `authentication_failed`

400 Bad Request - `validation_error`

404 Not Found

​Success Codes

​Error Codes

​Error Response Format

​Common Error Codes and their solutions

​401 Unauthorized - authentication_failed

​400 Bad Request - validation_error

​404 Not Found

Success Codes

Error Codes

Error Response Format

Common Error Codes and their solutions

401 Unauthorized - `authentication_failed`

400 Bad Request - `validation_error`

404 Not Found