Sign in
Job Contacts

Update a Job Contact

OAuth Scope

This endpoint requires the following OAuth scope manage_job_contacts.

post/jobcontact/{uuid}.json

Path parameters

uuidstring uuid required

UUID of the Job Contact

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 - The record was updated successfully

errorCodenumber
messagestring

Example response

{
  "message": "OK"
}

Changes

Changed in 2 of the 50 revisions of this API.115

  • 638a8df09bf411See the full diff
    • ▲

      the is_primary_contact request property type/format changed from string/ to /

      request-property-type-changed

    • ●

      removed the request property active

      request-property-removed

  • ca9b053c43735See the full diff
    • ○

      added the non-success response with the status 401

      response-non-success-status-added

    • ○

      added the non-success response with the status 403

      response-non-success-status-added

    • ○

      added the non-success response with the status 404

      response-non-success-status-added

    • ○

      added the non-success response with the status 429

      response-non-success-status-added

    • ○

      added the non-success response with the status 500

      response-non-success-status-added