API Reference

Create tax

post
https://open-api.guesty.com/v1/taxes

Create tax configuration with the provided settings.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
  1. The unit (listing) id on which the new tax will apply.
  2. To apply the tax on account level, leave this field empty.
string
enum
required
  1. The tax type.
  2. Each tax type can only be defined once on account/listing level.
string
enum
required

Determines whether the tax amount should be treated as a fixed or percentage value

Allowed:
number
required
≥ 0
  1. the amount of the tax, could be a fixed value or percentage whether units is 'FIXED' or 'PERCENTAGE' respectively.
  2. when 'FIXED' then 'amount' has to be greater then 0
  3. when 'PERCENTAGE' then 'amount' has to be greater then 0 and smaller or equal to 100
string
enum
required

Determines by what factor the tax amount will be multiplied

Allowed:
string
length ≤ 40

The name for the tax, which will be used accross guesty. there can be no two taxes with the same name.

boolean
  1. Relevant only when the units equals 'PERCENTAGE'
  2. When equals 'true', then the tax will be calculated on all fees and 'appliedOnFees' must contain all values
appliedOnFees
array of strings
appliedOnFees
boolean
  1. When set to 'true' and 'appliedByDefaultOnChannels' is not empty, then Guesty will prededuct the tax from the accommodation fare.
  2. can not be 'true' when 'appliedByDefaultOnChannels' is empty
appliedByDefaultOnChannels
array of strings
appliedByDefaultOnChannels
conditionalOverrides
object

Set additional conditions for this tax

channelOverrides
array of objects

Channel-specific overrides for this tax. Each entry customizes the tax for a specific channel.

channelOverrides
boolean
Responses

400

The input provided is invalid.

Updated 11 days ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 11 days ago