---
title: "Create a contact"
method: POST
path: "/consumers/{consumer_id}/invoicing/contacts"
tags: ["Invoicing", "Contacts"]
---

# Create a contact

`POST /consumers/{consumer_id}/invoicing/contacts`

Create a new contact.

## Path parameters

- `consumer_id` string, uuid, required

## Request body

- ContactItemIn
  - `is_prospect` boolean, nullable — Is a prospect?
  - `is_customer` boolean, nullable — Is a customer?
  - `is_supplier` boolean, nullable — Is a supplier?
  - `is_company` boolean, nullable — Is a company?
  - `company_name` string, nullable — Name of the company
  - `first_name` string, nullable — Firstname
  - `last_name` string, nullable — Lastname
  - `email` string, nullable — Email
  - `phone` string, nullable — Phone
  - `mobile` string, nullable — Mobile
  - `company_id` string, nullable — Technical id of the contact' company in Chift
  - `vat` string, nullable — VAT number
  - `company_number` string, nullable — Company number (identification number different than the VAT (e.g. siret))
  - `currency` string, nullable — Currency matching target sofware name
  - `language` string, nullable — Language matching target sofware name
  - `comment` string, nullable — Comment
  - `customer_account_number` string, nullable — Number of the accounting account used for sales (e.g. 701000)
  - `supplier_account_number` string, nullable — Number of the accounting account used for purchases (e.g. 601000)
  - `birthdate` string, date, nullable — Birthdate
  - `gender` 'H' | 'F' | 'N/A'
  - `addresses` AddressItemInInvoicing[], nullable — Addresses
    - `address_type` 'main' | 'delivery' | 'invoice' | 'other', required
    - `name` string, nullable
    - `number` string, nullable
    - `box` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `email` string, nullable
    - `street` string, required
    - `city` string, required
    - `postal_code` string, required
    - `country` string, required — Format: ISO 3166-1 codes.

## Response `200`

Successful Response

- ContactItemOut
  - `id` string, required — Technical id in Chift
  - `source_ref` Ref, required
    - `id` string, nullable — Technical id in the target software
    - `model` string, nullable — Name of the model/entity in the target software
  - `is_prospect` boolean, nullable — Is a prospect?
  - `is_customer` boolean, nullable — Is a customer?
  - `is_supplier` boolean, nullable — Is a supplier?
  - `is_company` boolean, nullable — Is a company?
  - `company_name` string, nullable — Name of the company
  - `first_name` string, nullable — Firstname
  - `last_name` string, nullable — Lastname
  - `email` string, nullable — Email
  - `phone` string, nullable — Phone
  - `mobile` string, nullable — Mobile
  - `company_id` string, nullable — Technical id of the contact' company in Chift
  - `vat` string, nullable — VAT number
  - `company_number` string, nullable — Company number (identification number different than the VAT (e.g. siret))
  - `currency` string, nullable — Currency matching target sofware name
  - `language` string, nullable — Language matching target sofware name
  - `comment` string, nullable — Comment
  - `customer_account_number` string, nullable — Number of the accounting account used for sales (e.g. 701000)
  - `supplier_account_number` string, nullable — Number of the accounting account used for purchases (e.g. 601000)
  - `birthdate` string, date, nullable — Birthdate
  - `gender` 'H' | 'F' | 'N/A'
  - `addresses` AddressItemOutInvoicing[], nullable — Addresses
    - `address_type` 'main' | 'delivery' | 'invoice' | 'other', required
    - `name` string, nullable
    - `number` string, nullable
    - `box` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `email` string, nullable
    - `street` string, nullable
    - `city` string, nullable
    - `postal_code` string, nullable
    - `country` string, nullable — Format: ISO 3166-1 codes.
  - `external_reference` string, nullable — External reference of the contact in the invoicing system

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

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