Workforce
Create employee
Call Outcome
Company Category
Contract Type
Custom Field
Delivery Method
Industry
Lead Source
Loss Reason
Market Sector
Project Stages
Task List
Tender Type
Webhook Message
Workforce
Create employee
POST
/
api
/
2023-01
/
workforce
/
employees
curl --request POST \
--url https://api.buildr.com/api/2023-01/workforce/employees \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '{
"workforce_employee": {
"birthday": "2021-01-01",
"email": "anthony@example.com",
"last_name": "Edwards",
"legal_first_name": "Anthony",
"notes": "This is why you always leave a note",
"phone": "555-555-5555",
"preferred_first_name": "Tony",
"role_id": "734",
"manager_id": "140",
"start_date": "2021-01-01",
"address": {
"street_address": "123 Main St",
"street_address2": "Apt 1",
"city": "Los Angeles",
"state": "CA",
"zip": "90001",
"country": "US"
}
}
}'
{
"workforce_employee": {
"id": "140",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"birthday": "2021-01-01",
"last_name": "Edwards",
"legal_first_name": "Anthony",
"notes": "This is why you always leave a note",
"phone": "555-555-5555",
"preferred_first_name": "Tony",
"start_date": "2021-01-01",
"email": "anthony@example.com",
"address": {
"street_address": "123 Main St",
"street_address2": "Apt 1",
"city": "Los Angeles",
"state": "CA",
"zip": "90001",
"country": "US"
},
"role": {
"id": "734",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Project Manager",
"abbreviation": "PM"
},
"manager": {
"id": "687",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"legal_first_name": "Markus",
"preferred_first_name": "Mookie",
"last_name": "Betts",
"email": "mookie@example.com",
"role": {
"id": "734",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Project Manager",
"abbreviation": "PM"
}
}
}
}
Headers
Body
application/json
Example:
"anthony@example.com"
Example:
"Edwards"
Example:
"Anthony"
Role ID to be associated with this employee
Example:
"734"
Example:
"2021-01-01"
Example:
"2021-01-01"
Example:
"This is why you always leave a note"
Example:
"555-555-5555"
Example:
"Tony"
Workforce Employee Manager to be associated with this employee
Example:
"140"
Example:
"123 Main St"
Example:
"Apt 1"
Example:
"Los Angeles"
Example:
"90001"
Available options:
AU
, CA
, GB
, IS
, NZ
, UK
, US
Example:
"US"
Example:
"CA"
Response
201 - application/json
Created Response
Example:
"140"
Example:
"2023-02-14T18:13:00Z"
Example:
"2023-04-03T20:16:30Z"
Example:
"2021-01-01"
Example:
"Edwards"
Example:
"Anthony"
Example:
"This is why you always leave a note"
Example:
"555-555-5555"
Example:
"Tony"
Example:
"2021-01-01"
Example:
"anthony@example.com"
Example:
"123 Main St"
Example:
"Apt 1"
Example:
"Los Angeles"
Example:
"90001"
Available options:
AU
, CA
, GB
, IS
, NZ
, UK
, US
Example:
"US"
Example:
"CA"
Example:
"734"
Example:
"2023-02-14T18:13:00Z"
Example:
"2023-04-03T20:16:30Z"
Example:
"Project Manager"
Example:
"PM"
Example:
"687"
Example:
"2023-02-14T18:13:00Z"
Example:
"2023-04-03T20:16:30Z"
Example:
"Markus"
Example:
"Betts"
Example:
"mookie@example.com"
Example:
"734"
Example:
"2023-02-14T18:13:00Z"
Example:
"2023-04-03T20:16:30Z"
Example:
"Project Manager"
Example:
"PM"
Example:
"Mookie"
curl --request POST \
--url https://api.buildr.com/api/2023-01/workforce/employees \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '{
"workforce_employee": {
"birthday": "2021-01-01",
"email": "anthony@example.com",
"last_name": "Edwards",
"legal_first_name": "Anthony",
"notes": "This is why you always leave a note",
"phone": "555-555-5555",
"preferred_first_name": "Tony",
"role_id": "734",
"manager_id": "140",
"start_date": "2021-01-01",
"address": {
"street_address": "123 Main St",
"street_address2": "Apt 1",
"city": "Los Angeles",
"state": "CA",
"zip": "90001",
"country": "US"
}
}
}'
{
"workforce_employee": {
"id": "140",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"birthday": "2021-01-01",
"last_name": "Edwards",
"legal_first_name": "Anthony",
"notes": "This is why you always leave a note",
"phone": "555-555-5555",
"preferred_first_name": "Tony",
"start_date": "2021-01-01",
"email": "anthony@example.com",
"address": {
"street_address": "123 Main St",
"street_address2": "Apt 1",
"city": "Los Angeles",
"state": "CA",
"zip": "90001",
"country": "US"
},
"role": {
"id": "734",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Project Manager",
"abbreviation": "PM"
},
"manager": {
"id": "687",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"legal_first_name": "Markus",
"preferred_first_name": "Mookie",
"last_name": "Betts",
"email": "mookie@example.com",
"role": {
"id": "734",
"created_at": "2023-02-14T18:13:00Z",
"updated_at": "2023-04-03T20:16:30Z",
"name": "Project Manager",
"abbreviation": "PM"
}
}
}
}