Status Code API Responses

Use this page describes potential status codes that you may receive through the API

Status Code Definitions

The Shape API uses HTTP Status codes to reflect a successful or unsuccessful request. 2XX status codes represent a successful request, 4XX status codes represent an error took place. If you receive an error status code, check the body for an error code and message.

Successful Request – 200

This means, that the request was received and understood and is being processed.

Unauthorized – 401

Invalid or missing credentials. This can mean that a required API authorization key or parameter has not been provided, the value supplied is invalid, or the combination of provided fields is invalid.

Conflict – 409

This occurs when trying to overwrite a resource, ex. when creating an event with a time conflict

Bad Request – 400

User error. This can mean that a required field or parameter has not been provided, the value supplied is invalid, or the combination of provided fields is invalid. If you are receiving this response, then please evaluate your API request call for errors.

Not Found – 404

If you receive this response code, then the resource doesn’t exists, ex. invalid/non-existent lead id

Limit Exceeded – 429

Rate Limit Exceeded. This occurs when the limit is exceeded, an API request will fail and an error status code will be returned if you’ve gone beyond your API rate limits.