201

Created

2xx · Success

The request succeeded and a new resource was created.

What does HTTP 201 Created mean?

The request was fulfilled and resulted in a new resource being created, typically after a POST or PUT. The response usually includes a Location header pointing to the new resource.

2xx responses mean the request was successfully received, understood, and accepted. This is the range you want to see for healthy requests.

When you'll see HTTP 201

  • A POST creates a new resource
  • A PUT creates a resource at a new URL

Example

POST /api/users HTTP/1.1

→ HTTP/1.1 201 Created
Location: /api/users/42

Related 2xx status codes

Look up and search every HTTP status code in one place.

Open the HTTP Status Code tool