FAfactorialhr
Companies > LegalEntity

Creates a Legal entity

Changed on

Creates a Legal entity

post/api/2026-10-01/resources/companies/legal_entities

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/companies/legal_entities
  • Auth
    API key in header x-api-key

Request body

company_idstring required

company identifier

countrystring required

country code of the legal entity

legal_namestring required

Legal name of the legal entity

currencystring required

The currency code in ISO 4217 format

tinstring

Tax identification number

citystring

City of the legal entity

statestring

State of the legal entity

postal_codestring

Postal code of the legal entity

address_line_1string

Address line 1 of the legal entity

address_line_2string

Address line 2 of the legal entity

Example request

{
  "company_id": "1",
  "country": "es",
  "legal_name": "Acme Inc.",
  "currency": "EUR",
  "tin": "H41192410",
  "city": "Barcelona",
  "state": "Barcelona",
  "postal_code": "08005",
  "address_line_1": "Carrer Mallorca",
  "address_line_2": "61 2A"
}

Response

CREATED

idstring required

identifier of the legal entity

company_idstring required

company identifier

countrystring required

Country code of the jurisdiction the legal entity is registered in (lowercase two-letter code, e.g. "es").

legal_namestring required

Legal name of the legal entity

currencystring required

The currency code in ISO 4217 format

tinstring

Tax identification number

siretstring

SIRET number (France-specific). System for identifying French establishments. 14-digit identifier for each French establishment.

citystring

City of the legal entity

statestring

State of the legal entity

postal_codestring

Postal code of the legal entity

address_line_1string

Address line 1 of the legal entity

address_line_2string

Address line 2 of the legal entity

Example response

{
  "id": "754",
  "company_id": "1",
  "country": "es",
  "legal_name": "Acme Inc.",
  "currency": "EUR",
  "tin": "H41192410",
  "siret": "12345678901234",
  "city": "Barcelona",
  "state": "Barcelona",
  "postal_code": "08005",
  "address_line_1": "Carrer Mallorca",
  "address_line_2": "61 2A"
}

Changes