TestingAPIs is still being built. If something breaks, email support@testingapis.com.

Create a person

POSThttps://api.testingapis.com/api/PeopleSign in to see this endpoint's URL

The server assigns the next free ID; any ID in the body is ignored.

Request body

Optional. application/json, text/json, application/*+json, application/xml, text/xml, application/*+xml. Model: Person. The record to create.

Example body
{
  "firstName": "Aisha",
  "lastName": "Khan",
  "username": "akhan",
  "email": "akhan@example.com",
  "gender": "female",
  "dateOfBirth": "1991-04-12",
  "phone": "+1-555-200-3000",
  "avatar": "https://i.pravatar.cc/150?img=1",
  "address": {
    "street": "42 Baker Street",
    "city": "London",
    "state": "England",
    "zip": "NW1 6XE",
    "country": "United Kingdom",
    "geo": {"lat": 51.5237, "lng": -0.1585}
  },
  "company": {"name": "Nimbus Cloud Systems", "title": "Product Manager"}
}

Responses

200
OK
201
Created; returns { message, data } with the generated ID.
400
The body is missing, malformed or fails validation.

Example

Request
curl -X POST "https://api.testingapis.com/api/People" \
  -H "Content-Type: application/json" \
  -d '{"firstName": "Aisha", "lastName": "Khan", "username": "akhan", "email": "akhan@example.com", "gender": "female", "dateOfBirth": "1991-04-12", "phone": "+1-555-200-3000", "avatar": "https://i.pravatar.cc/150?img=1", "address": {"street": "42 Baker Street", "city": "London", "state": "England", "zip": "NW1 6XE", "country": "United Kingdom", "geo": {"lat": 51.5237, "lng": -0.1585}}, "company": {"name": "Nimbus Cloud Systems", "title": "Product Manager"}}' \
  -H "X-TestingApis-Key: YOUR_API_KEY"
Response201 Created
{
  "message": "Person created successfully",
  "data": {
    "id": 24,
    "firstName": "Aisha",
    "lastName": "Khan",
    "username": "akhan",
    "email": "akhan@example.com",
    "gender": "female",
    "dateOfBirth": "1991-04-12",
    "phone": "+1-555-200-3000",
    "avatar": "https://i.pravatar.cc/150?img=1",
    "address": {
      "street": "42 Baker Street",
… (9 more lines)

Sign in to see the details

The parameters, request and response examples and the live Try it panel for this endpoint are for signed-in members. Accounts are free and take a few seconds to create.