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

# Add/modify contractor

`POST /company/contractors`

## Request

- Base URL: `https://api.altera.co`
- URL: `https://api.altera.co/company/contractors`
- Auth: API key in header `Authorization`

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

## Other responses

- `401`: KEY_EXPIRED: a verified API key has expired. This requires that the company still has OpenAPI access. Unknown/invalid keys can receive the gateway 403.

## Changes

- **2026-10-12** `45544bcb4e8a`: 1 info
  - added the non-success response with the status `401`
- **2024-08-26** `64c683372c45`: 1 info
  - endpoint added
- **2024-08-26** `a2d864f3a8db`: 1 breaking
  - api path removed without deprecation

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

---

[API](https://skmtc.dev/altera-co/apis/altera-api.md) - [All operations](https://skmtc.dev/altera-co/apis/altera-api/llms.txt) - [OpenAPI document](https://skmtc.dev/altera-co/apis/altera-api/revisions/45544bcb4e8a?raw)