FAfactorialhr
Webhooks

Companies > LegalEntity > Creates

Subscription_type: companies/legal_entity/create

postWebhookWebhooks > Companies > LegalEntity > Creates

Payload

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 payload

{
  "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"
}

Response

Return a 200 status to indicate that the data was received successfully

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.