v50

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

Company Contacts

Create a new Company Contact

OAuth Scope

This endpoint requires the following OAuth scope manage_customer_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/companycontact.json

Request body

company_uuidstring uuid

The UUID of the company this contact belongs to

firststring

First name of the company contact. Used for identifying and addressing the contact in communications.

laststring

Last name of the company contact. Used together with the first name to identify the contact.

phonestring

Primary phone number for the contact. Used for voice communications with the contact. Should include area code and can include international code.

mobilestring

Mobile phone number for the contact. Used for SMS communications and alternative voice contact. Should include area code and can include international code.

emailstring email

Email address of the contact. Used for sending email communications, quotes, invoices, and other electronic correspondence.

typestring

Specifies the type of contact. Common values include 'BILLING' for billing contacts and 'JOB' for job contacts. This field determines how the contact is used in the system.

is_primary_contactstring

Indicates whether this contact is the primary contact for the company. Value of 1 means this is the primary contact, 0 means it is not. A company should have only one active primary contact.

uuidstring uuid

Unique identifier for this record

Example request

{
  "company_uuid": "123e4567-02d4-4ed9-a25b-23f9484d2f2b",
  "uuid": "123e4567-5fd5-4f90-b189-23f943d02b9b"
}

Response

Success

errorCodenumber

messagestring

Example response

{
  "message": "OK"
}