If your CleverTap API request fails, you will receive an error response including a response code and a message explaining the reason for the error.

The following response code pattern applies across API requests:

  • 200 - Successful Request
  • 400 - Bad Request. Some mandatory parameter was missing. Remove comments from JSON.
  • 429 - Too many requests were made concurrently. Three concurrent requests are the max. Please try again after 10 minutes.
  • 500 - Server Error
  • 503 - Service Unavailable. Please retry later.

We also have endpoint-specific errors that are documented below.

Upload Events API

  • 509 - Event name mandatory
  • 512 - Invalid event structure
  • 513 - Raised a restricted system event
  • 522 - Event properties limit exceeded
  • 523 - Missing identity
  • 524 - Data neither event nor profile
  • 525 - Timestamp not in UNIX epoch format
  • 526 - objectId invalid
  • 528 - Discarded event is raised.
  • 555 - Miscellaneous server error

Uploads User Profiles API

  • 514 - Gender invalid
  • 515 - Email invalid
  • 516 - Phone number invalid
  • 517 - Employment status invalid
  • 518 - Education status invalid
  • 519 - Marital status invalid
  • 520 - Age invalid
  • 523 - Missing identity
  • 524 - Data neither event nor profile
  • 525 - Timestamp not an epoch
  • 526 - objectId invalid
  • 555 - Miscellaneous server error

Upload Device Tokens API

  • 530 - Invalid ‘objectId’
  • 531 - Invalid token data
  • 532 - Token ‘id’ is not present
  • 533 - Token ‘type’ is not present
  • 534 - Token ‘type’ is not valid for ‘objectId’
  • 535 - Invalid token data

Did this page help you?