TrueURL

201 Created

A requisição foi bem-sucedida e criou um novo recurso, geralmente após um POST ou PUT. O cabeçalho Location, se presente, aponta para o novo recurso.

Categoria
2xx Sucesso
Frase de motivo
Created
Redirecionamento
Não
Cacheável por padrão
Não

201 Created significa que a requisição foi atendida e criou um ou mais recursos novos. As APIs costumam retorná-lo após um POST para uma coleção ou um PUT para uma URL nova. O principal recurso novo é identificado pelo cabeçalho Location ou, se não houver Location, pela URL da requisição.

O corpo geralmente descreve o novo recurso ou traz links para ele. Validadores como ETag na resposta se referem à representação recém-criada, e o cliente pode usá-los em requisições condicionais posteriores.

Ao contrário do que acontece em uma resposta 3xx, um cabeçalho Location em um 201 não é um redirecionamento. Navegadores e clientes HTTP não o seguem automaticamente.

Exemplo de resposta

HTTP
HTTP/1.1 201 Created
Date: Fri, 06 Nov 2026 10:15:32 GMT
Location: https://api.example.com/v1/orders/8412
Content-Type: application/json
Content-Length: 30

{"id":8412,"status":"pending"}

SEO e verificação de redirecionamentos

O 201 é coisa de APIs e de processadores de formulários, não de páginas que devem ser indexadas. Os rastreadores que o recebem o tratam como sucesso, mas a URL de uma página pública deve retornar 200. Depois do envio de um formulário no navegador, o padrão habitual é responder com 303 See Other, para que recarregar a página de resultado não envie o formulário de novo.

Causas comuns e casos de uso

  • Uma API REST criou um registro (POST /orders) e retorna a URL dele em Location.
  • Um arquivo foi enviado com PUT para uma URL que não existia antes.
  • Uma verificação de redirecionamentos mostra 201 para uma URL que você esperava que fosse uma página: o endpoint é uma API ou a verificação usou POST. Confira o método HTTP em Configurações avançadas.

Verificador de redirecionamento de URL

Veja todos os códigos de status que uma URL retorna, salto a salto, com o verificador de redirecionamento gratuito do TrueURL.