> ## Documentation Index
> Fetch the complete documentation index at: https://docs.altera.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Add/modify contractor

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



## OpenAPI

````yaml /openapi/openapi.json post /company/contractors
openapi: 3.1.0
info:
  title: OpenAPI
  version: '1.0'
  summary: OpenApi
  contact:
    name: Altera Support
    url: https://altera.co
    email: wsparcie@altera.co
  description: ''
  license:
    url: https://altera.co/regulamin
    name: Terms of services for Altera.app
servers:
  - url: https://api.altera.co
    description: Production endpoint (proxied)
security:
  - Authorization: []
tags:
  - name: Configuration
  - name: Data export
  - name: Expenses
  - name: Sales
paths:
  /company/contractors:
    parameters: []
    post:
      tags:
        - Configuration
      summary: Add/modify contractor
      description: >-
        This endpoint provides the means for adding/updating contractor data for
        later use in the system
      operationId: postcompany-contractors
      requestBody:
        content:
          application/json:
            schema:
              type: object
              x-examples:
                Example 1:
                  contractorId: 4527
                  contractorRegion: POLAND
                  country: PL
                  contractorType: COMPANY
                  contractorName: Apple Computer, Inc.
                  street: Rejsi Manor
                  houseNumber: '465'
                  flatNumber: '42'
                  city: Menahga
                  postCode: 58-261
                  taxIdentificationNumber: '8958666780'
                  email: spend@different.com
                  areaNumber: ''
                  phoneNumber: '337507196'
              properties:
                contractorId:
                  type: integer
                  description: >-
                    Identifier used if we wish to update an already existing
                    contractor
                contractorRegion:
                  type: string
                  enum:
                    - POLAND
                    - EU
                    - OUTSIDE_OF_EU
                  example: POLAND
                country:
                  type: string
                  description: Two letter country code according to ISO 3166-1 alfa-2
                contractorType:
                  type: string
                  enum:
                    - COMPANY
                    - PRIVATE_PERSON
                  example: PRIVATE_PERSON
                contractorName:
                  type: string
                street:
                  type: string
                houseNumber:
                  type: string
                flatNumber:
                  type: string
                city:
                  type: string
                postCode:
                  type: string
                taxIdentificationNumber:
                  type: string
                email:
                  type: string
                areaNumber:
                  type: string
                phoneNumber:
                  type: string
              required:
                - contractorRegion
                - country
                - contractorType
                - contractorName
            examples:
              Example 1:
                value:
                  contractorId: 4527
                  contractorRegion: POLAND
                  country: PL
                  contractorType: COMPANY
                  contractorName: Apple Computer, Inc.
                  street: Rejsi Manor
                  houseNumber: '465'
                  flatNumber: '42'
                  city: Menahga
                  postCode: 58-261
                  taxIdentificationNumber: '8958666780'
                  email: spend@different.com
                  areaNumber: ''
                  phoneNumber: '337507196'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                x-examples:
                  Example 1:
                    result: OK
                    data:
                      contractorId: 4527
                properties:
                  result:
                    type: string
                    default: OK
                    example: OK
                  data:
                    type: object
                    properties:
                      contractorId:
                        type: integer
                        example: 15232
              examples:
                Example 1:
                  value:
                    result: OK
                    data:
                      contractorId: 4527
components:
  securitySchemes:
    Authorization:
      name: Authorization
      type: apiKey
      in: header
      description: OpenApi Key created within Altera.app for a certain company

````