Skip to main content
POST
Create tax

Authorizations

X-API-Key
string
header
default:your_tyms_sk_or_partner_key
required

Business secret tyms_sk_... for business-scoped routes. Partner secret for register-business and referred-business distributor routes.

Body

application/json
name
string
required

Required. Display name, for example VAT or WHT.

percentage
number
required

Required. Human rate. Send 7.5 for 7.5 percent, not 0.075.

currency
string

Optional currency code.

is_deduction
boolean

true creates a withholding tax. Default false (sales tax).

payable_account
string

Account name, code, or id. Sales tax: Expenses. Withholding: Liabilities.

receivable_account
string

Account name, code, or id. Sales tax: Liabilities. Withholding: Assets.

Response

Tax created

status
string
required
Example:

"success"

message
string
required
data
any

Single resource, array of resources, statement sections, or async job metadata — see each operation's example.

meta
object

Pagination (page, limit, total) and/or report range (from, to). Cash flow may include previous_period_end.