# Insert company

Endpoint: POST /enrichment/companies
Version: 2.51.0
Security: OAuth2

## Request fields (application/json):

  - `externalId` (string, required)
    External id of the company that is globally unique across the provided company data
    Example: "DE01"

  - `externalClientId` (string)
    Identifier of the client entity in the source system which can be used to separate data
    Example: "EXTERNAL_CLIENT_ID"

  - `code` (string)
    Code of the company in the source system (not unique across clients)
    Example: "CODE1"

  - `name` (string, required)
    Name of the company
    Example: "Acmne Corp."

  - `nameAlternative1` (string)
    Alternative name of the company
    Example: "Acmne Corp."

  - `nameAlternative2` (string)
    Alternative name of the company
    Example: "Acmne Corp."

  - `nameAlternative3` (string)
    Alternative name of the company
    Example: "Acmne Corp."

  - `nameAlternative4` (string)
    Alternative name of the company
    Example: "Acmne Corp."

  - `street` (string)
    Street and street number where the company is located
    Example: "Hauptstr. 1"

  - `addressAdditional` (string)
    Additional address data (e.g. apartment or suite)
    Example: "Eingang B"

  - `postcode` (string)
    Postcode where the company is located
    Example: "10001"

  - `city` (string)
    City where the company is located
    Example: "Berlin"

  - `state` (string)
    State where the company is located
    Example: "Berlin"

  - `countryCode` (string,null)
    Two letter country code as defined in ISO 3166-1 alpha-2
    Enum: "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW", null

  - `vatIds` (array)
    List of VAT IDs assigned to the company
    Example: [{"id":"DE123456789","countryCode":"DE"}]

  - `vatIds.id` (string)

  - `taxIds` (array)
    List of Tax IDs assigned to the company
    Example: [{"id":"123-456-789","type":"TIN"}]

  - `taxIds.type` (string)

  - `customFields` (object)
    List of key value pairs containing custom fields from the source system

  - `customMetadata` (object)
    Any nested structure with metadata that source system needs to send
    Example: {"someTopLevelProperty":"value1","someNestedProperty":{"nestedProperty":"value2"},"someArrayProperty":["value3","value4"]}

## Response 200 fields (application/json):

  - `id` (string, required)
    Example: "3a429dc8-56d4-42ef-a4cf-2ebc9ad1ef38"

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)


## Response 429 fields