# Create a company

Required scopes: contact-data:write

Endpoint: POST /companies
Version: v1
Security: http, oauth2

## Request fields (application/json):

  - `external_id` (string,null)
    Can be used to add an identifier from an external system, must be unique within integration (integration's slug)

  - `external_origin` (string)
    If not set, integration's slug will be used as default

  - `vendor_identifier` (string,null)

  - `company_name` (string, required)

  - `locale` (string,null)

  - `tax_uid` (string,null)

  - `taxation` (boolean)

  - `iban` (string,null)

  - `bic` (string,null)

  - `fax` (string,null)

  - `phone` (string,null)

  - `homepage` (string,null)

  - `email` (string,null)
    Can be comma separated list of emails

  - `email_general` (string,null)

  - `invoice_by_post` (boolean)

  - `invoices_by_email` (boolean)

  - `person_attention_to` (string,null)

  - `address_invoice_title` (string,null)

  - `address_invoice_street` (string,null)

  - `address_invoice_street2` (string,null)

  - `address_invoice_house` (string,null)

  - `address_invoice_zip` (string,null)

  - `address_invoice_state` (string,null)

  - `address_invoice_town` (string,null)

  - `address_invoice_is_delivery` (boolean)

  - `address_invoice_country` (string)
    Format: ISO 3166-1 alpha-2 / ISO 3166-1 alpha-3 / ISO-3166-1 numeric / Name You can use this field to associate a contact with a specific country.
We try to find the corresponding country based on the provided value.
If country code/name is valid but not created yet, it will be created.
If country is not valid, the space's default country will be used.

Will be ignored if address_invoice_country_id is set.

  - `address_invoice_country_id` (string,null)
    You can use this field to associate a contact with a specific country already present in the system.

  - `delivery_person_attention_to` (string,null)

  - `address_delivery_title` (string,null)

  - `address_delivery_street` (string,null)

  - `address_delivery_street2` (string,null)

  - `address_delivery_house` (string,null)

  - `address_delivery_zip` (string,null)

  - `address_delivery_state` (string,null)

  - `address_delivery_town` (string,null)

  - `address_delivery_country` (string)
    Format: ISO 3166-1 alpha-2 / ISO 3166-1 alpha-3 / ISO-3166-1 numeric / Name You can use this field to associate a contact with a specific country.
We try to find the corresponding country based on the provided value.
If country code/name is valid but not created yet, it will be created.
If country is not valid, the space's default country will be used.

Will be ignored if address_delivery_country_id is set.

  - `address_delivery_country_id` (string,null)
    You can use this field to associate a contact with a specific country already present in the system.

  - `client_id` (string,null)

  - `business_field` (string,null)
    If field not exists, a new one will be created

  - `company_size` (string,null)

  - `company_revenue` (string,null)

  - `tags` (array)

  - `custom_fields` (array)
    Example: "{<slug>: <value>}"

## Response 200 fields (application/json):

  - `id` (string, required)

  - `external_id` (string,null, required)
    Can be used to add an identifier to the client from an external system, must be unique

  - `external_origin` (string,null, required)
    If originated from external system origin is added

  - `vendor_identifier` (string,null, required)

  - `company_name` (string,null, required)

  - `locale` (string,null, required)

  - `tax_uid` (string,null, required)

  - `taxation_enabled` (boolean, required)
    Can be used to indicate reverse charge ie

  - `iban` (string,null, required)

  - `bic` (string,null, required)

  - `email` (string,null, required)

  - `email_general` (string,null, required)

  - `phone` (string,null, required)

  - `fax` (string,null, required)

  - `homepage` (string,null, required)

  - `invoices_by_post` (boolean, required)

  - `invoices_by_email` (boolean, required)

  - `business_field` (any, required)

  - `company_size` (any, required)

  - `company_revenue` (any, required)

  - `person_attention_to` (string,null, required)

  - `address_invoice_title` (string,null, required)

  - `address_invoice_street` (string,null, required)

  - `address_invoice_house` (string,null, required)

  - `address_invoice_street2` (string,null, required)

  - `address_invoice_zip` (string,null, required)

  - `address_invoice_state` (string,null, required)

  - `address_invoice_town` (string,null, required)

  - `address_invoice_country` (any, required)

  - `address_invoice_is_delivery` (boolean, required)

  - `delivery_person_attention_to` (string,null, required)

  - `address_delivery_title` (string,null, required)

  - `address_delivery_street` (string,null, required)

  - `address_delivery_house` (string,null, required)

  - `address_delivery_street2` (string,null, required)

  - `address_delivery_zip` (string,null, required)

  - `address_delivery_state` (string,null, required)

  - `address_delivery_town` (string,null, required)

  - `address_delivery_country` (any, required)

  - `client` (any, required)

  - `tags` (array)

  - `tags.title` (string, required)

  - `contacts` (array)

  - `contacts.gender` (string,null, required)

  - `contacts.first_name` (string,null, required)

  - `contacts.last_name` (string,null, required)

  - `contacts.title_suffix` (string,null, required)

  - `contacts.position` (string,null, required)

  - `contacts.birthday` (string,null, required)

  - `contacts.telephone` (string,null, required)

  - `contacts.telephone_private` (string,null, required)

  - `contacts.mobile` (string,null, required)

  - `contacts.mobile_private` (string,null, required)

  - `contacts.email_private` (string,null, required)

  - `contacts.address_street` (string,null, required)

  - `contacts.address_house` (string,null, required)

  - `contacts.address_street2` (string,null, required)

  - `contacts.address_zip` (string,null, required)

  - `contacts.address_state` (string,null, required)

  - `contacts.address_town` (string,null, required)

  - `contacts.address_country` (any, required)

  - `contacts.owner` (any, required)

  - `contacts.companies` (array)

  - `contacts.custom_fields` (object, required)
    The key is the field name for your custom field, value type depends on the field type

  - `contacts.created_at` (string, required)

  - `contacts.updated_at` (string,null, required)

  - `contacts.deleted_at` (string,null, required)

  - `contacts.contact_company` (object)
    Added included via relationship (contact -> companies or company -> contacts)

## Response 401 fields (application/json):

  - `message` (string, required)
    Error overview.

## Response 422 fields (application/json):

  - `message` (string, required)
    Errors overview.

  - `errors` (object, required)
    A detailed description of each field that failed validation.