Create a new user Run in API Explorer

POST /users

Creates a new user with a full name, list of jobs, and address.

application/json

Body Required

  • full_name string

    First and last name of the user.

  • jobs array[object]

    List of jobs the user has had.

    Hide jobs attributes Show jobs attributes object
    • title string

      Title of the job.

    • company string

      Name of the company where the user worked.

    • year integer

      Year when the user worked at the company.

  • address object

    One of:
    personalAddress object companyAddress object

Responses

  • 201 application/json

    User successfully created.

    Hide response attributes Show response attributes object
    • id string(uuid)

      ID of the user.

    • createdAt string(date-time)

      Creation date and time.

    • full_name string

      First and last name of the user.

    • jobs array[object]

      List of jobs the user has had.

      Hide jobs attributes Show jobs attributes object
      • title string

        Title of the job.

      • company string

        Name of the company where the user worked.

      • year integer

        Year when the user worked at the company.

    • address object

      One of:
      personalAddress object companyAddress object
POST /users 
curl \
 --request POST https://reqres.in/api/users \
 --header "Content-Type: application/json" \
 --data '{"full_name":"John Doe","jobs":[{"title":"Software Engineer","company":"Bump.sh","year":"2020"}],"address":{"full_address":"25 rue Lenepveu, 49100 Angers","country":"France"}}'
Request examples 
{
  "full_name": "John Doe",
  "jobs": [
    {
      "title": "Software Engineer",
      "company": "Bump.sh",
      "year": "2020"
    }
  ],
  "address": {
    "full_address": "25 rue Lenepveu, 49100 Angers",
    "country": "France"
  }
}
Response examples (201) 
{
  "id": "string",
  "createdAt": "2025-05-04T09:42:00Z",
  "full_name": "John Doe",
  "jobs": [
    {
      "title": "Software Engineer",
      "company": "Bump.sh",
      "year": "2020"
    }
  ],
  "address": {
    "full_address": "25 rue Lenepveu, 49100 Angers",
    "country": "France"
  }
}