---
title: "POST /counterparties"
method: POST
path: "/counterparties"
tags: ["Counterparty"]
---

# POST /counterparties

`POST /counterparties`

Create a new counterparty. A Counterparty describes any commercial relations with a company. Counterparties are automatically created from the invoices.

## Request body

- APICounterpartyExplicitCreation
  - `address` Address
    - `address_line_1` string, nullable
    - `address_line_2` string, nullable
    - `city` string, nullable
    - `country` string, nullable
    - `postal_code` string, nullable
    - `state` string, nullable
  - `contact` APICounterpartyContact
    - `email` string, email, required
    - `first_name` string, required
    - `last_name` string, required
    - `phone_number` string, required
  - `identifier` string, required — Legal identifier of the business, such as its SIRET or SIREN in France. Must not contain spaces.
  - `identifier_type` 'belgium_registration_number' | 'bsn' | 'cif' | 'hr_nummer' | 'kvk' | 'name' | 'nif' | 'siren' | 'siret' | 'steuernummer' | 'vat_number', required — Type of legal business identifier of the business, such as the SIRET in France.
  - `name` string, nullable — Legal name of the business.
  - `relation_types` string[], required
  - `vat_number` string, nullable — VatNumber

## Response `200`

OK

## Other responses

- `201` — Created

---

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