API status codes

API status codes indicate whether a request was successful or if something went wrong.

2xx – Succes

All codes starting with a 2 (e.g., 200 or 201) mean that the request was executed successfully.

Note: in some systems, such as Klaviyo, anything that is not 200 (e.g., 201) may still be displayed as an error message in red. This does not necessarily mean that there is an error.

4xx – Client-side error

Codes starting with a 4 indicate a problem on your end. For example:

  • An incorrect template ID in your JSON

  • An error in the design

  • Forgetting a merge variable

  • A missing comma or syntax error in the JSON

The exact reason for the error message is always in the API response.

Examples:

400 – Bad Request: Check that all fields contain correct data and that the JSON syntax is correct. Often it is a small mistake, such as a forgotten merge variable.

401 – Unauthorized: This means an authentication problem. Check if your API key is correct.

5xx – Problem on Print.one's side

These codes indicate a problem with Print.one. In most cases, this is only temporary. Wait a moment, try again, and contact us if the problem persists.

All error messages are automatically sent to our system so that our team is immediately informed and can help you if necessary.