HTTP 201 Created

A new resource exists as a result of this request. A well-behaved API also sends a Location header pointing at it, and usually the created representation as the body.

Why you would test it

Check the Location header, not just the status — clients that build the follow-up URL themselves break the first time the server changes its id scheme.

Endpoints that return 201

42 endpoints in this playground answer with 201. Every one is free, needs no signup, and can be called from the browser or with curl.

POST https://funapi.dev/api/friends/v1/characters — Created (Friends API)
POST https://funapi.dev/api/friends/v1/characters/bulk — All items created (Friends API)
POST https://funapi.dev/api/superheroes/v1/heroes — Created (Superhero API)
POST https://funapi.dev/api/superheroes/v1/heroes/versus — Fight resolved, random winner (Superhero API)
POST https://funapi.dev/api/pizza/v1/orders — Order placed (Pizza Orders API)
POST https://funapi.dev/api/coffee/v1/orders — Order placed (Coffee Shop API)
POST https://funapi.dev/api/football/v1/matches — Match played, random score (Football API)
POST https://funapi.dev/api/movies/v1/movies — Created (Movies API)
POST https://funapi.dev/api/movies/v1/movies/{id}/poster — Uploaded (Movies API)
POST https://funapi.dev/api/wizarding/v1/students — Enrolled (Harry Potter API)
POST https://funapi.dev/api/galaxy/v1/characters — Created (Star Wars API)
POST https://funapi.dev/api/holmes/v1/suspects — Created (Sherlock Holmes API)
POST https://funapi.dev/api/pokemon/v1/pokemon — Created (Pokémon API)
POST https://funapi.dev/api/pokemon/v1/battles — Battle resolved, random winner (Pokémon API)
POST https://funapi.dev/api/middleearth/v1/fellowship — Recruited (Middle-earth API)
POST https://funapi.dev/api/webhooks/v1/subscriptions — Registered, includes a signingSecret (Webhooks API)
POST https://funapi.dev/api/webhooks/v1/trigger — Delivered to one or more subscriptions (Webhooks API)
POST https://funapi.dev/api/office/v1/employees — Hired (The Office API)
POST https://funapi.dev/api/dinopark/v1/dinosaurs — Created (Dino Park API)
POST https://funapi.dev/api/dinopark/v1/incidents/breach — Incident logged (Dino Park API)
POST https://funapi.dev/api/marvel/v1/heroes — Recruited (Marvel API)
POST https://funapi.dev/api/marvel/v1/missions — Mission created (Marvel API)
POST https://funapi.dev/api/got/v1/nobles — Created (Game of Thrones API)
POST https://funapi.dev/api/got/v1/battles — Battle resolved (Game of Thrones API)
POST https://funapi.dev/api/rickandmorty/v1/characters — Created (Rick and Morty API)

…and 17 more endpoints across the catalog.

Other success codes

All HTTP status codes · All 37 mock REST APIs · Getting started guide