GuidesAPI ReferenceDiscussions
API Reference

Create a new Client

post
https://api.servicem8.com/api_1.0/company.json

OAuth Scope

This endpoint requires the following OAuth scope manage_customers.

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Client record to create

string
required
length ≤ 100

Company Name

string

Australian Business Number. A unique 11-digit identifier issued by the Australian Taxation Office to businesses. Required for tax compliance and validation of business identity in Australia.

string
length ≤ 500

The complete address of the company in a single text field. Supports up to 500 characters and may contain multiple lines. Used when individual address components (street, city, etc.) are not available or when displaying the full address in a single field.

string
length ≤ 500

The complete billing address for the company in a single text field. Supports up to 500 characters and may contain multiple lines. Used for invoicing and financial transactions when the billing address differs from the primary company address.

uuid

If provided, specifies the UUID of this Site's parent Company. If blank, this record is a Head Office rather than a Site. This field is only present on ServiceM8 Accounts with the Company Sites addon activated.

uuid

Unique identifier for this record

string
string
length ≤ 500
string
string
string
string
string
string

JSON Array of Badge UUIDs

uuid
string
string
integer
Responses

Updated 12 days ago

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 12 days ago