Create Personnel | propelone

curl -X POST https://https//https/workforce/personnel \
     -H "{{tenant_key_name}}: {{tenant_key_value1}}|{{tenant_key_value2}}" \
     -H "Content-Type: multipart/form-data" \
     -F email="jane.doe@example.com" \
     -F notes="Experienced technician specialized in HVAC systems and electrical maintenance." \
     -F mobile="+15551234567" \
     -F licenses="[{\"workforce_license_id\":\"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\"license_number\":\"HVAC-12345\",\"dates\":{\"issued\":\"2020-05-01\",\"expires\":\"2025-05-01\"},\"status\":\"active\"}]" \
     -F hire_date="2023-08-15" \
     -F job_title="Senior HVAC Technician" \
     -F last_name="Doe" \
     -F schedules="[{\"shift_date\":\"2024-06-01\",\"start_time\":\"08:00\",\"end_time\":\"16:00\",\"schedule_type\":\"regular\",\"status\":\"confirmed\",\"notes\":\"Day shift\"}]" \
     -F first_name="Jane" \
     -F phone_work="+15557654321" \
     -F employee_id="EMP1024" \
     -F hourly_rate="32.75" \
     -F phone_mobile="+15559876543" \
     -F certifications="[{\"workforce_certification_id\":\"c1d2e3f4-5678-90ab-cdef-1234567890ab\",\"certification_number\":\"CERT-98765\",\"dates\":{\"issued\":\"2021-03-10\",\"expires\":\"2024-03-10\"},\"status\":\"active\"}]" \
     -F specializations="[{\"workforce_specialization_id\":\"f1e2d3c4-b5a6-7890-cdef-0987654321ab\",\"proficiency_level\":\"expert\",\"years_experience\":8,\"is_primary\":true}]" \
     -F emergency_contacts="[{\"name\":\"John Doe\",\"relationship\":\"Spouse\",\"phone_primary\":\"+15551239876\",\"phone_secondary\":\"+15551239877\",\"email\":\"john.doe@example.com\",\"address\":\"123 Main St, Anytown, USA\",\"is_primary\":true}]" \
     -F overtime_multiplier="1.5" \
     -F emergency_contact_name="John Doe" \
     -F emergency_contact_phone="+15551239876" \
     -F workforce_personnel_type_id="456e7890-e89b-12d3-a456-426614174001"

Request

This endpoint expects a multipart form.

emailstringRequired

Required without user_id: Email

notesstringRequired

Optional: Additional notes - max 2000 chars - “Specialized in HVAC systems”

mobilestringRequired

Required without user_id: Mobile

licensesstringRequired

Optional: Array of licenses - JSON format with workforce_license_id, license_number, dates, status

hire_datestringRequired

Optional: Hire date - YYYY-MM-DD format - “2024-01-15”

job_titlestringRequired

last_namestringRequired

Required without user_id: Last name

schedulesstringRequired

Optional: Array of Emergency Contacts - JSON format with shift_date,start_time,end_time,schedule_type,status,notes

first_namestringRequired

Required without user_id: First name

phone_workstringRequired

Optional: Work phone - E.164 format - “+1234567890”

employee_idstringRequired

Optional: Employee identifier - max 50 chars - “EMP001”

hourly_ratestringRequired

Optional: Hourly rate - decimal format - “25.50”

phone_mobilestringRequired

Optional: Mobile phone - E.164 format - “+1234567891”

certificationsstringRequired

Optional: Array of certifications - JSON format with workforce_certification_id, certification_number, dates, status

specializationsstringRequired

Optional: Array of specializations - JSON format with workforce_specialization_id, proficiency_level, years_experience, is_primary

emergency_contactsstringRequired

Optional: Array of Emergency Contacts - JSON format with name,relationship,phone_primary,phone_secondary,email,address,is_primary

overtime_multiplierstringRequired

Optional: Overtime multiplier - decimal format - “1.5”

emergency_contact_namestringRequired

Optional: Emergency contact name - max 255 chars - “Jane Doe”

emergency_contact_phonestringRequired

Optional: Emergency contact phone - E.164 format - “+1234567892”

workforce_personnel_type_idstringRequired

Required: Personnel type UUID - from personnel-types endpoint - “456e7890-e89b-12d3-a456-426614174001”

Response

Successful response

Headers

Request

Response