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

# Create a contact

`POST /contacts`

Use this endpoint to create a new contact within the selected workspace.

## Headers

- `x-oneflow-api-token` string, required
- `x-oneflow-user-email` string, email, required

## Request body

- object — Request body for a create contact request.
  - `company_name` string — The name of the contact person's company.
  - `company_registration_number` string — The registration number of the contact person's company.
  - `country_code` string, country_code — The country code of the contact.
  - `date_of_birth` string — The date of birth of the contact person.
  - `email` string, email, required — The email of the contact person.
  - `name` string, required — The name of the contact person.
  - `notes` string — The notes add by the contact person.
  - `phone_number` string, nullable — The phone number of the contact person.
  - `title` string — The title of the contact person.
  - `workspace_id` integer, required — The unique ID of the workspace.

## Response `200`

Returns the created contact.

- object
  - `company_name` string, required
  - `company_registration_number` string, required
  - `country_code` string, required
  - `created_time` string, datetime, nullable, required
  - `date_of_birth` string, required
  - `email` string, email, required
  - `id` integer, required
  - `name` string, required
  - `notes` string, required
  - `phone_number` string, nullable, required
  - `title` string, required
  - `updated_time` string, datetime, nullable, required
  - `workspace_id` integer, required

## Other responses

- `400` — Invalid format or content of the request.
- `401` — The API token or the user email is invalid.
- `403` — The request is not authorized by the server.
- `404` — A required entity is missing.

---

[API](https://skmtc.net/oneflow/apis/public-api-for-oneflow.md) · [All operations](https://skmtc.net/oneflow/apis/public-api-for-oneflow/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneflow/public-api-for-oneflow/versions/0e73a45dec15/schema)