Create a location

Create a new location object.

What is a location?

A location object is useful for tracking expenses based on locations. You can sync your locations with your choice of accounting software or import using a CSV file.

In Xero, the BILL location object is required for tracking expenses and syncing successfully. In Intuit QuickBooks, the location object and location-based tracking is not supported.

Display location in the BILL web app

You can display location numbers with the BILL web app.

  1. In the BILL web app, click SETTINGS at the top-right.
  2. Click Preferences under Accounting.
  3. Click the edit icon at the top-right.
  4. Set Use Locations as Yes and then click SAVE.
Form Data
string
required

Developer key (sent to you when you create a developer account)

string
required

API session ID generated with /Login.json

object
required
Response

Response body
object
integer

Response status.

  • 0: Success response
  • 1: Error response. Only error_code and error_message is returned in response_data.
string

Response status.

  • Success: Success response
  • Error: Error response. Only error_code and error_message is returned in response_data.
object
string

Object type. Set as Location.

string

BILL-generated location ID. The value begins with loc.

string

Name for identifying the location in BILL and in your choice of accounting software.

string

Object visibility status. Inactive objects are hidden by default in the BILL web app.

  • 1: Active
  • 2: Inactive
string

Unique location name

string

Parent location ID. Set this value if the current location ID is a child object.

string

Location description

string

Created date and time

string

Updated date and time

string

Parent location ID that the current ID is merged into

string

Error code (only when response_status is 1)

string

Error message (only when response_status is 1)

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