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

# POST /contacts/

`POST /contacts/`

## Request

- Base URL: `https://api.manatal.com/open/v3`
- URL: `https://api.manatal.com/open/v3/contacts/`
- Auth: API key in header `Authorization`

A viewset for viewing contacts of a client

## Request body

- object
  - `id` integer
  - `full_name` string, required: Full name of the contact
  - `display_name` string: Name to display which can be different from full name
  - `email` string, email, nullable: Contact email
  - `picture` string, uri: Link to the contact picture
  - `phone_number` string: Contact phone number
  - `description` string: Description of the contact
  - `organization` integer, required: Organization to which the contact belongs.
  - `custom_fields` object: Contact values for custom fields defined in Manatal.
  - `creator` integer: User who created the contact
  - `created_at` string, date-time: Date at which the contact was created
  - `updated_at` string, date-time

## Response `201`

- object
  - `id` integer
  - `full_name` string, required: Full name of the contact
  - `display_name` string: Name to display which can be different from full name
  - `email` string, email, nullable: Contact email
  - `picture` string, uri: Link to the contact picture
  - `phone_number` string: Contact phone number
  - `description` string: Description of the contact
  - `organization` integer, required: Organization to which the contact belongs.
  - `custom_fields` object: Contact values for custom fields defined in Manatal.
  - `creator` integer: User who created the contact
  - `created_at` string, date-time: Date at which the contact was created
  - `updated_at` string, date-time

---

[API](https://skmtc.dev/manatal/apis/manatal-open-api.md) - [All operations](https://skmtc.dev/manatal/apis/manatal-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/manatal/apis/manatal-open-api/revisions/564633b3d03b?raw)