HTTP response codes

FreeClimb uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error in the HTTP request provided, and codes in the 5xx range indicate an internal FreeClimb error.

Response Headers

When a POST request is made FreeClimb generates a unique request ID that is returned in the response header. FreeClimb will reuse this request ID if there are multiple webhooks for your initial request. This request ID can be used with the Performance Query Language (PQL) to Filter Logs.



200 - OK

Request was successfully processed.

201 - Created

Resource was successfully created.

202 - Accepted

Request was successfully queued and is being processed

204 - No Content

Request was successfully processed; the response does not include a message body.

400 - Bad Request

Request was unacceptable, often due to an invalid parameter value or missing a required parameter.

401 - Unauthorized

Account credentials were invalid.

403 - Forbidden

Account credentials not authorized.

404 - Not Found

Requested resource doesn’t exist.

405 - Method Not Allowed

HTTP Method in the request was invalid.

409 - Conflict

Request could not be completed due to a conflict with the current state of the resource.

500, 502, 503, 504 - Server Errors

Error on FreeClimb's end.