Created — the request was successful and a new resource was created
What 201 Means
The 201 error on the HTTP Status-Codes indicates created — the request was successful and a new resource was created. This typically occurs due to successful post request resulting in a new database record.
A 201 Created status indicates that the request has been fulfilled and has resulted in one or more new resources being created. The new resource is typically identified by the URL in the Location header.
Technical Background
The 201 Created status indicates that the request has been fulfilled and has resulted in one or more new resources being created.
The primary resource created by the request is typically identified by either a Location header field in the response or by the URI of the request itself. This is the standard response for successful POST or PUT operations that generate new entities.
Common Causes
- Successful POST request resulting in a new database record
- PUT request creating a new file on the server
- Successful registration or signup process
Typical Scenarios
- A user successfully creates a new account on a website
- A developer uses an API to upload a new image to a cloud bucket
What to Know
A 201 status provides definitive confirmation of resource creation. Checking the 'Location' header in the response is the standard way to retrieve the URI of the newly generated resource.
Frequently Asked Questions
Common questions about HTTP 201 error
200 OK means the request was successful in general, while 201 specifically means a new resource was created as a result.