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

# Create contact

`POST /contacts/`

## Headers

- `x-simple-workspace` string, required
- `x-piriod-test-mode` boolean

## Request body

- ContactWrite
  - `customer` string, nullable
  - `orgunit` string, nullable
  - `name` string, required
  - `email` string, email, required
  - `phone` string, nullable
  - `invoicing` boolean
  - `collections` boolean

## Response `201`

Contact created.

- Contact
  - `id` string
  - `customer` string, nullable — Customer ID this contact belongs to.
  - `orgunit` string, nullable — Organisation unit ID. Optional sub-grouping inside a customer.
  - `name` string, required
  - `email` string, email, required
  - `phone` string, nullable
  - `invoicing` boolean — Whether this contact receives invoice emails.
  - `collections` boolean — Whether this contact receives collection reminders.
  - `created` string, date-time
  - `updated` string, date-time

## Other responses

- `400` — Request body or query parameters failed validation.

---

[API](https://skmtc.net/piriod/apis/piriod-api.md) · [All operations](https://skmtc.net/piriod/apis/piriod-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/piriod/piriod-api/revisions/70cbc827dc7b/schema)