API Reference
Log In
API Reference

Create Expense

post
https://app.hosttools.com/api/createExpense

Adds an expense or extra income to a listing, as Add expense or extra income in Owner Statements does. An expense needs a category and chargeTo. Requires the ownerStatements:write scope.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

An expense needs category and chargeTo; on extra income they are ignored.

string
enum
required

expense is money spent on the listing; extraIncome is money the listing earned outside its bookings.

Allowed:
string
required

_id of the listing it's for (from Get Listings)

string
required
number
required

Above 0, in the listing's currency, with no more decimals than the currency has (2 for USD, 0 for JPY). kind says which way the money goes.

string
enum

Expenses only. Use custom with customCategory for anything else.

Allowed:
string
length ≤ 100

The category's name, with category custom only

string
enum

Expenses only. owner puts the expense on the owner's statement; internal keeps it as the manager's own cost, left off the statement. Extra income always goes to the owner, so it's ignored there.

Allowed:
string
length ≤ 1000
Headers
string

Partner API key (deprecated — use OAuth 2.0 for new integrations)

string

User's authentication token (legacy). Use Authorization Bearer header for new integrations.

Responses

403

The OAuth token doesn't have the ownerStatements:write scope

429

Too many requests

Updated about 11 hours ago

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

Updated about 11 hours ago