StaffCreate a staff member

Create a staff member

Needs: Staff, Read-write

Creates a staff member from the fields below. Any other field returns a 422 naming the unsupported fields. To create several people with roles and locations, or to set custom attributes, use bulk create.

curl -X POST "https://app.imploy.com.au/api/integrations/v1/staff" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
  "first_name": "Example",
  "last_name": "Worker",
  "email": "example.worker@example.com",
  "phone": "0400 000 000"
}'
{
  "data": {
    "id": 31,
    "first_name": "Example",
    "last_name": "Worker",
    "email": "example.worker@example.com",
    "phone": "0400 000 000",
    "status": "Active",
    "created_at": "2026-01-12T03:20:41.000000Z",
    "updated_at": "2026-02-03T08:05:10.000000Z"
  }
}
POST
/staff
POST
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

An organisation access token that starts with imp_at_. Send it as Authorization: Bearer imp_at_XXXX.

An organisation access token that starts with imp_at_. Send it as Authorization: Bearer imp_at_XXXX.
Content-Typestring
Required

The media type of the request body

Options: application/json
first_namestring
Required

Up to 100 characters.

last_namestring
Required

Up to 100 characters.

emailstring
Required

A valid email, up to 255 characters.

phonestring

Up to 40 characters, or null.

statusstring

Active, Inactive, Pending, Non-compliant or Archived.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. An organisation access token that starts with imp_at_. Send it as Authorization: Bearer imp_at_XXXX.

Body

application/json
first_namestring
Required

Up to 100 characters.

last_namestring
Required

Up to 100 characters.

emailstring
Required

A valid email, up to 255 characters.

phonestring

Up to 40 characters, or null.

statusstring

Active, Inactive, Pending, Non-compliant or Archived.

Responses