Qué significa
La petición tuvo éxito y creó un recurso nuevo. La cabecera Location suele apuntar a él.
Causas habituales
- Un POST a una colección creó un registro
- Un PUT creó un recurso en una URL nueva
Cómo solucionarlo
Si eres el cliente o visitante
Lee la cabecera Location para obtener la URL del nuevo recurso, o usa el cuerpo devuelto si la API incluye el objeto creado.
Si administras el sitio o la API
Incluye Location con la nueva URL e, idealmente, la representación creada. No devuelvas 201 si no se creó nada; los reintentos idempotentes que encuentran un elemento existente pueden devolver 200 o 409.
Respuesta de ejemplo
HTTP/1.1
HTTP/1.1 201 Created
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Location: /users/42
Content-Type: application/json
{
"id": 42,
"name": "Ada"
}Especificación
Preguntas frecuentes
› ¿La cabecera Location es obligatoria con 201?
Es muy recomendable. Sin ella, los clientes deben adivinar la nueva URL a partir del cuerpo.
› ¿Qué diferencia hay entre 201 y 202?
201 significa que el recurso ya existe. 202 significa que la petición se aceptó y se procesará más tarde.