HTTP Status Codes
HTTP 201 Created
Created — the request was successful and a new resource was created
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.
Visual summary
A quick reference view of how HTTP 201 works: Data submitted by the client results in a newly instantiated object or record.
What 201 Means
The shortest useful reading of this status code.
Created means the request was successful and a new resource was created.
This status falls into the 2xx class, indicating a successful outcome for the request.
Quick read
Created
the request was successful and a new resource was created
Technical Context
How this status behaves without turning the page into a repair guide.
Standard usage
The 201 Created status indicates that the request has been fulfilled and has resulted in one or more new resources being created.
Technical nuance
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.
Related HTTP Codes
Nearby HTTP status codes help clarify how 201 differs inside the same response family.
201
Created
the request was successful and a new resource was created
200
OK
the request succeeded and the server returned the expected response
202
Accepted
the request has been accepted for processing, but is not yet complete
204
No Content
the request was successful but there is no content to return
Common Causes
Successful POST request resulting in a new database record
A common condition that triggers a 201 response when the web server evaluates the transaction.
PUT request creating a new file on the server
A common condition that triggers a 201 response when the web server evaluates the transaction.
Successful registration or signup process
A common condition that triggers a 201 response when the web server evaluates the transaction.
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 interpretation questions about HTTP 201.
200 OK means the request was successful in general, while 201 specifically means a new resource was created as a result.