Skip to content

2xx Success

201 Created

A new resource was created, usually after a POST to an API. The Location header can point to it.

When you see it

  • A successful POST that stored a new record (a user, an order, a comment).

What to do

  1. 1

    Return 201 with the new resource (and a Location header) from create endpoints; clients and API docs rely on it.

In Laravel

return response()->json($post, 201); or return (new PostResource($post))->response()->setStatusCode(201); An API resource returned from a store() action after a model was just created gets 201 automatically.

Check the status of a URL

The first line of the response shows the status code; -L follows redirects and shows each step.

curl -I https://example.com/page
curl -IL https://example.com/old-page

Frequently asked questions

What does HTTP 201 mean?

A new resource was created, usually after a POST to an API. The Location header can point to it.

How does Laravel handle 201?

return response()->json($post, 201); or return (new PostResource($post))->response()->setStatusCode(201); An API resource returned from a store() action after a model was just created gets 201 automatically.

Get new articles in your inbox

Practical tutorials and deep dives, about once a week. No spam, unsubscribe anytime.

Privacy policy

Add DEV Talk to your Home Screen

  1. 1 Tap the Share button in Safari's toolbar.
  2. 2 Scroll down and tap Add to Home Screen.
  3. 3 Tap Add. Open it from the Home Screen to read like an app and to turn on notifications with the bell.

We use cookies to improve your experience and analyze traffic. By continuing, you agree to our Privacy Policy.