FAfactorialhr
Finance > TaxRate

Creates a Tax rate

Changed on

Creates a Tax rate

post/api/2026-10-01/resources/finance/tax_rates

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/finance/tax_rates
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: finance
    • or API key in header x-api-key

Request body

descriptionstring

An optional text describing the tax rate's purpose or context.

ratenumber

Specifies the numerical percentage for the tax rate between -1 and 1.

tax_type_idstring

The identifier of the related TaxType record.

external_idstring

The external id of the tax rate.

Example request

{
  "description": "VAT for general goods",
  "rate": 0.07,
  "tax_type_id": "1234",
  "external_id": "EXT-RATE-001"
}

Response

CREATED

idstring required

Factorial id

ratenumber required

Specifies the numerical percentage for the tax rate between -1 and 1.

descriptionstring

An optional text describing the tax rate's purpose or context.

tax_type_idstring required

The identifier of the related TaxType record.

external_idstring

The external id of the tax rate.

updated_atstring required

Last update date of the tax rate.

Example response

{
  "id": "123",
  "rate": 0.07,
  "description": "VAT for general goods",
  "tax_type_id": "1234",
  "external_id": "EXT-RATE-001",
  "updated_at": "2025-01-01T00:00:00.000Z"
}

Changes