201 Created indica che la richiesta è stata soddisfatta e ha creato una o più nuove risorse. Le API lo restituiscono tipicamente dopo un POST su una collezione o un PUT su un nuovo URL. La nuova risorsa principale è identificata dall’intestazione Location oppure, se Location manca, dall’URL della richiesta.
Di solito il corpo descrive la nuova risorsa o rimanda a essa. I validatori presenti nella risposta, come ETag, si riferiscono alla rappresentazione appena creata, quindi il client può usarli per le successive richieste condizionali.
A differenza di quanto accade in una risposta 3xx, un’intestazione Location in un 201 non è un reindirizzamento. Browser e client HTTP non la seguono automaticamente.
Esempio di risposta
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 dei redirect
Il 201 è tipico delle API e dei gestori di moduli, non delle pagine da indicizzare. I crawler che lo ricevono lo trattano come un successo, ma l’URL di una pagina pubblica dovrebbe restituire 200. Dopo l’invio di un modulo nel browser, la prassi è rispondere invece con 303 See Other, così che ricaricare la pagina del risultato non invii di nuovo il modulo.
Cause comuni e casi d’uso
- Un’API REST ha creato un record (
POST /orders) e ne restituisce l’URL inLocation. - Un file è stato caricato con
PUTsu un URL che prima non esisteva. - Una verifica redirect mostra 201 per un URL che ti aspettavi fosse una pagina: l’endpoint è un’API oppure la verifica ha usato POST. Controlla il metodo HTTP nelle Impostazioni avanzate.