2xx SuccessCommonly usedRFC 9110
201Created
Resource was successfully created.
What it means
The request succeeded and a new resource was created. Should include a Location header pointing to the newly created resource. Most commonly returned after a POST request that creates a new record.
When to use it
- ✓POST request successfully created a new record
- ✓PUT request created a resource (when it did not exist before)
- ✓User registration succeeded
- ✓File upload created a new file
Code Examples
Express — Create a user
javascript
app.post('/users', async (req, res) => {
const user = await db.users.create(req.body);
res.status(201)
.set('Location', `/users/${user.id}`)
.json(user);
});Quick Facts
Code201
CategorySuccess
SpecRFC 9110
CommonYes
Relevant Headers
Location
URL of the newly created resource