Create a new tax rate

Create a new tax rate account

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

x-monite-versionstringRequired
x-monite-entity-idstringRequired
The ID of the entity that owns the requested resource.

Request

This endpoint expects an object.
codestringOptional<=500 characters
Code for the tax rate from the accounting platform
descriptionstringOptional<=2048 characters
Description of the tax rate
effective_tax_rateintegerOptional0-10000
Effective tax rate in percent [minor units](https://docs.monite.com/references/currencies#minor-units). Example: 12.5% is 1250.
namestringOptional<=500 characters
Name of the tax rate

Response

Successful Response
idstringformat: "uuid"
created_atdatetime
The timestamp when the tax rate was created.
updated_atdatetime
The timestamp when the tax rate was last updated.
codestring
Code for the tax rate from the accounting platform.
componentslist of objects
descriptionstring
Description of the tax rate
effective_tax_rateinteger

Effective tax rate in percent minor units. Example: 12.5% is 1250.

is_externalbooleanDefaults to false
Whether the tax rate is from an external system
namestring
statusstring
total_tax_rateinteger

Total (not compounded) sum of the components of a tax rate in minor units. Example: 12.5% is 1250.

Errors

400
Post Accounting Tax Rates Request Bad Request Error
401
Post Accounting Tax Rates Request Unauthorized Error
403
Post Accounting Tax Rates Request Forbidden Error
422
Post Accounting Tax Rates Request Unprocessable Entity Error
500
Post Accounting Tax Rates Request Internal Server Error