v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-211931021.7 MB

Job Contacts

Create a new Job Contact

OAuth Scope

This endpoint requires the following OAuth scope manage_job_contacts.

Record UUID

UUID is optional for record creation. If no UUID is supplied, a UUID will be automatically generated for the new record and returned in the x-record-uuid response header.

post/jobcontact.json

Request body

job_uuidstring uuid

UUID of the job this contact is associated with. Each job contact must be linked to a valid job in the system. This field cannot be changed once set.

firststring

First name of the job contact. This information is synced with the job's contact information fields depending on the contact type.

laststring

Last name of the job contact. This information is synced with the job's contact information fields depending on the contact type.

phonestring

Landline or office phone number of the job contact. Format is flexible but should represent a valid phone number. This field syncs with the job's phone_1 field for job contacts or phone_2 field for billing contacts.

mobilestring

Mobile phone number of the job contact. Format is flexible but should represent a valid mobile number. This field syncs with the job's mobile field for job contacts or billing_mobile field for billing contacts.

emailstring email

Email address of the job contact. Should be a valid email format. Used for sending job-related communications. This field syncs with the job's email field for job contacts or billing_email field for billing contacts.

typestring

Type of contact relationship to the job. Valid values are: 'JOB' (or 'Job Contact'), 'BILLING' (or 'Billing Contact'), or 'Property Manager'. Controls which job fields are updated when this contact record changes.

{"stackTrail":"components:schemas:JobContactCreate:properties:is_primary_contact","oasType":"schema","type":"unknown","description":"DEPRECATED"}

uuidstring uuid

Unique identifier for this record

Example request

{
  "job_uuid": "123e4567-65f9-48f6-b5d5-23f946e3196b",
  "uuid": "123e4567-2b6e-4cc4-aa5d-23f9486bcefb"
}

Response

Success

errorCodenumber

messagestring

Example response

{
  "message": "OK"
}