---
title: "Create single contact"
method: POST
path: "/contacts"
tags: ["contact"]
---

# Create single contact

`POST /contacts`

Create single contact

## Request body

- object
  - `type` string, required — Contact type
  - `name` string, required — Contact name
  - `title` string, nullable — Contact title
  - `firstName` string, nullable — Contact first name
  - `lastName` string, nullable — Contact last name
  - `preferredName` string, nullable — Contact preferred name
  - `occupation` string, nullable — Contact occupation
  - `companyName` string, nullable — Contact company name
  - `providerNumber` string, nullable — Contact provider number
  - `doctorType` 'GP' | 'Specialist', nullable — Contact doctor type
  - `email` string, email, required — Contact email
  - `addressL1` string, nullable — Contact address line 1
  - `addressL2` string, nullable — Contact address line 2
  - `addressL3` string, nullable — Contact address line 3
  - `suburb` string, nullable — Contact city
  - `state` string, nullable — Contact state
  - `postalCode` string, nullable — Contact post code
  - `country` string, nullable — Contact country
  - `phoneNumbers` object[]
    - `type` 'Mobile' | 'Home' | 'Work' | 'Fax' | 'Other', nullable — Phone number type
    - `code` string, nullable — Phone country code
    - `phoneNumber` string, required — Phone number

## Response `200`

Successfully created contact

- object
  - `id` integer, required — Contact id
  - `type` string, nullable, required — Contact type
  - `name` string, nullable, required — Contact name
  - `title` string, nullable, required — Contact title
  - `firstName` string, nullable, required — Contact first name
  - `lastName` string, nullable, required — Contact last name
  - `preferredName` string, nullable, required — Contact preferred name
  - `occupation` string, nullable, required — Contact occupation
  - `companyName` string, nullable, required — Contact company name
  - `providerNumber` string, nullable, required — Contact provider number
  - `doctorType` string, nullable, required — Contact doctor type
  - `associatedPatientIds` number[], nullable, required — The associated patients' id in this contact
  - `associatedInvoiceIds` number[], nullable, required — The associated invoices' id in this contact
  - `associatedCaseIds` number[], nullable, required — The associated invoices' id in this contact
  - `email` string, nullable, required — Contact email
  - `addressL1` string, nullable, required — Contact address line 1
  - `addressL2` string, nullable, required — Contact address line 2
  - `addressL3` string, nullable, required — Contact address line 3
  - `suburb` string, nullable, required — Contact city
  - `state` string, nullable, required — Contact state
  - `postalCode` string, nullable, required — Contact post code
  - `country` string, nullable, required — Contact country
  - `phoneNumbers` object[]
    - `type` 'Mobile' | 'Home' | 'Work' | 'Fax' | 'Other', nullable — Phone number type
    - `code` string, nullable — Phone country code
    - `phoneNumber` string, required — Phone number
  - `archived` boolean, nullable — Whether the contact has been archived
  - `createdAt` union — Object creation date time
    - string
    - string
  - `updatedAt` union — Object update date time
    - string
    - string

## Other responses

- `500` — Error creating contact

---

[API](https://skmtc.dev/splose/apis/splose-public-api.md) · [All operations](https://skmtc.dev/splose/apis/splose-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/splose/splose-public-api/revisions/648d60075f00/schema)