Create an employee

POSThttps://api.testingapis.com/api/EmployeesSign 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: Employee. The record to create.

Example body

{
  "firstName": "Olivia",
  "lastName": "Bennett",
  "email": "olivia.bennett@nimbuscloud.example.com",
  "phone": "+1-555-101-1037",
  "department": "Executive",
  "title": "Chief Executive Officer",
  "salary": 285000,
  "hireDate": "2008-03-01",
  "managerId": null,
  "companyId": 1,
  "skills": ["Leadership", "Strategy", "Fundraising"],
  "address": {
    "street": "107 Oak Ave",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94105",
    "country": "USA",
    "geo": null
  },
  "active": true
}

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/Employees" \
  -H "Content-Type: application/json" \
  -d '{"firstName": "Olivia", "lastName": "Bennett", "email": "olivia.bennett@nimbuscloud.example.com", "phone": "+1-555-101-1037", "department": "Executive", "title": "Chief Executive Officer", "salary": 285000, "hireDate": "2008-03-01", "managerId": null, "companyId": 1, "skills": ["Leadership", "Strategy", "Fundraising"], "address": {"street": "107 Oak Ave", "city": "San Francisco", "state": "CA", "zip": "94105", "country": "USA", "geo": null}, "active": true}' \
  -H "X-TestingApis-Key: YOUR_API_KEY"

Response201 Created

{
  "message": "Employee created successfully",
  "data": {
    "id": 29,
    "firstName": "Olivia",
    "lastName": "Bennett",
    "email": "olivia.bennett@nimbuscloud.example.com",
    "phone": "+1-555-101-1037",
    "department": "Executive",
    "title": "Chief Executive Officer",
    "salary": 285000,
    "hireDate": "2008-03-01",
    "managerId": null,
    "companyId": 1,
… (12 more lines)

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.

Try itSign-in requiredUses your key

api.testingapis.com

curl -X POST 'https://api.testingapis.com/api/Employees' \
  -H 'Content-Type: application/json' \
  -H 'X-TestingApis-Key: YOUR_API_KEY' \
  -d '{"firstName": "Olivia", "lastName": "Bennett", "email": "olivia.bennett@nimbuscloud.example.com", "phone": "+1-555-101-1037", "department": "Executive", "title": "Chief Executive Officer", "salary": 285000, "hireDate": "2008-03-01", "managerId": null, "companyId": 1, "skills": ["Leadership", "Strategy", "Fundraising"], "address": {"street": "107 Oak Ave", "city": "San Francisco", "state": "CA", "zip": "94105", "country": "USA", "geo": null}, "active": true}'

const res = await fetch("https://api.testingapis.com/api/Employees", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-TestingApis-Key": "YOUR_API_KEY",
  },
  body: "{\"firstName\": \"Olivia\", \"lastName\": \"Bennett\", \"email\": \"olivia.bennett@nimbuscloud.example.com\", \"phone\": \"+1-555-101-1037\", \"department\": \"Executive\", \"title\": \"Chief Executive Officer\", \"salary\": 285000, \"hireDate\": \"2008-03-01\", \"managerId\": null, \"companyId\": 1, \"skills\": [\"Leadership\", \"Strategy\", \"Fundraising\"], \"address\": {\"street\": \"107 Oak Ave\", \"city\": \"San Francisco\", \"state\": \"CA\", \"zip\": \"94105\", \"country\": \"USA\", \"geo\": null}, \"active\": true}",
});
console.log(res.status, await res.text());

const res = await fetch("https://api.testingapis.com/api/Employees", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-TestingApis-Key": "YOUR_API_KEY",
  },
  body: "{\"firstName\": \"Olivia\", \"lastName\": \"Bennett\", \"email\": \"olivia.bennett@nimbuscloud.example.com\", \"phone\": \"+1-555-101-1037\", \"department\": \"Executive\", \"title\": \"Chief Executive Officer\", \"salary\": 285000, \"hireDate\": \"2008-03-01\", \"managerId\": null, \"companyId\": 1, \"skills\": [\"Leadership\", \"Strategy\", \"Fundraising\"], \"address\": {\"street\": \"107 Oak Ave\", \"city\": \"San Francisco\", \"state\": \"CA\", \"zip\": \"94105\", \"country\": \"USA\", \"geo\": null}, \"active\": true}",
});
const body: string = await res.text();
console.log(res.status, body);

import requests

res = requests.post(
    "https://api.testingapis.com/api/Employees",
    headers={
        "Content-Type": "application/json",
        "X-TestingApis-Key": "YOUR_API_KEY",
    },
    data="{\"firstName\": \"Olivia\", \"lastName\": \"Bennett\", \"email\": \"olivia.bennett@nimbuscloud.example.com\", \"phone\": \"+1-555-101-1037\", \"department\": \"Executive\", \"title\": \"Chief Executive Officer\", \"salary\": 285000, \"hireDate\": \"2008-03-01\", \"managerId\": null, \"companyId\": 1, \"skills\": [\"Leadership\", \"Strategy\", \"Fundraising\"], \"address\": {\"street\": \"107 Oak Ave\", \"city\": \"San Francisco\", \"state\": \"CA\", \"zip\": \"94105\", \"country\": \"USA\", \"geo\": null}, \"active\": true}",
)
print(res.status_code, res.text)

using System.Net.Http.Headers;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://api.testingapis.com/api/Employees");
request.Headers.TryAddWithoutValidation("X-TestingApis-Key", "YOUR_API_KEY");
request.Content = new StringContent("{\"firstName\": \"Olivia\", \"lastName\": \"Bennett\", \"email\": \"olivia.bennett@nimbuscloud.example.com\", \"phone\": \"+1-555-101-1037\", \"department\": \"Executive\", \"title\": \"Chief Executive Officer\", \"salary\": 285000, \"hireDate\": \"2008-03-01\", \"managerId\": null, \"companyId\": 1, \"skills\": [\"Leadership\", \"Strategy\", \"Fundraising\"], \"address\": {\"street\": \"107 Oak Ave\", \"city\": \"San Francisco\", \"state\": \"CA\", \"zip\": \"94105\", \"country\": \"USA\", \"geo\": null}, \"active\": true}");
request.Content.Headers.ContentType = MediaTypeHeaderValue.Parse("application/json");
using var response = await client.SendAsync(request);
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.testingapis.com/api/Employees"))
                .header("X-TestingApis-Key", "YOUR_API_KEY")
                .header("Content-Type", "application/json")
                .method("POST", HttpRequest.BodyPublishers.ofString("{\"firstName\": \"Olivia\", \"lastName\": \"Bennett\", \"email\": \"olivia.bennett@nimbuscloud.example.com\", \"phone\": \"+1-555-101-1037\", \"department\": \"Executive\", \"title\": \"Chief Executive Officer\", \"salary\": 285000, \"hireDate\": \"2008-03-01\", \"managerId\": null, \"companyId\": 1, \"skills\": [\"Leadership\", \"Strategy\", \"Fundraising\"], \"address\": {\"street\": \"107 Oak Ave\", \"city\": \"San Francisco\", \"state\": \"CA\", \"zip\": \"94105\", \"country\": \"USA\", \"geo\": null}, \"active\": true}"))
                .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader("{\"firstName\": \"Olivia\", \"lastName\": \"Bennett\", \"email\": \"olivia.bennett@nimbuscloud.example.com\", \"phone\": \"+1-555-101-1037\", \"department\": \"Executive\", \"title\": \"Chief Executive Officer\", \"salary\": 285000, \"hireDate\": \"2008-03-01\", \"managerId\": null, \"companyId\": 1, \"skills\": [\"Leadership\", \"Strategy\", \"Fundraising\"], \"address\": {\"street\": \"107 Oak Ave\", \"city\": \"San Francisco\", \"state\": \"CA\", \"zip\": \"94105\", \"country\": \"USA\", \"geo\": null}, \"active\": true}")
	req, err := http.NewRequest("POST", "https://api.testingapis.com/api/Employees", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-TestingApis-Key", "YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, err := io.ReadAll(res.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(res.StatusCode, string(data))
}

POSThttps://api.testingapis.com/api/Employees

Create an employee

Request body

Responses

Example

Related