---
title: "Add/modify contractor"
method: POST
path: "/company/contractors"
tags: ["Configuration"]
---

# Add/modify contractor

`POST /company/contractors`

This endpoint provides the means for adding/updating contractor data for later use in the system

## Request body

- object
  - `contractorId` integer — Identifier used if we wish to update an already existing contractor
  - `contractorRegion` 'POLAND' | 'EU' | 'OUTSIDE_OF_EU', required
  - `country` string, required — Two letter country code according to ISO 3166-1 alfa-2
  - `contractorType` 'COMPANY' | 'PRIVATE_PERSON', required
  - `contractorName` string, required
  - `street` string
  - `houseNumber` string
  - `flatNumber` string
  - `city` string
  - `postCode` string
  - `taxIdentificationNumber` string
  - `email` string
  - `areaNumber` string
  - `phoneNumber` string

## Response `200`

OK

- object
  - `result` string
  - `data` object
    - `contractorId` integer

## Changes

> 4 revisions in range; 1 could not be searched.

- **2024-08-26** `64c683372c45` — 1 info
  - endpoint added
- **2024-08-26** `a2d864f3a8db` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/altera-co/apis/openapi/changes/company/contractors/post.md)

---

[API](https://skmtc.dev/altera-co/apis/openapi.md) · [All operations](https://skmtc.dev/altera-co/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/altera-co/openapi/revisions/39a4dd6ca527/schema)