| Status code | 201 |
|---|---|
| Status text | Created |
| Category | 2xx Success |
| Response has body | Usually |
| Specification | RFC 9110 |
What does 201 Created mean?
The request succeeded and a new resource was created as a result. It belongs to the 2xx Success class, which means the request was received, understood and accepted.
When do APIs return 201?
The correct response to a POST that creates a resource.
How to fix a 201 Created
Nothing to fix. A well-behaved API also returns a Location header pointing at the new resource — check for it.
Reproduce a 201 response
The fastest way to understand a status code is to trigger one and read the full response. Open the
API tester and send a request to https://httpbin.org/status/201 — you will
see the 201 status along with every response header the server sent. Comparing those headers against
a working request is often what reveals the cause.
When you are debugging a real endpoint, check the response headers as carefully as the body, and confirm you are using the right HTTP method for the operation.
Related 2xx status codes
200 OK
The request succeeded and the response body contains the result.
202 Accepted
The request was accepted for processing, but the processing has not finished.
204 No Content
The request succeeded and there is deliberately no response body.
206 Partial Content
The server is delivering only part of the resource, as requested by a Range header.