`Location` Header

Indicates the URL to redirect the client to, or the URL of a newly created resource.

Header TypeResponse Header

SpecificationStandard RFC compliant

Associated CodesHTTP 201,HTTP 301,HTTP 302,HTTP 303,HTTP 307,HTTP 308

What is the Location header?

The Location response header serves two main functions: redirecting the client to a new URL, or pointing to the URI of a newly created resource.

Use on 201 Created: When a resource is successfully created via POST, always include the Location header pointing to the GET path of the new resource.
Ensure absolute URLs: While relative paths are supported in modern specs, using absolute URLs is safer for diverse API clients.

HTTP/1.1 201 Created
Location: https://api.apiguide.dev/v1/leads/lead_123

The request has been fulfilled and has resulted in a new resource being created.

The requested resource has been assigned a new permanent URI and future references should use it.

The requested resource resides temporarily under a different URI.

Directs the client to get the requested resource at another URI using a GET request.

The resource resides temporarily under a different URI. Method must not be changed.

The resource has been permanently moved. Method must not be changed.