---
updatedAt: 2025-10-02T22:25:43.000Z
agentTools:
  projectIndex: https://developer.bill.com/v2/llms.txt
---

# Update a location

Update a 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**.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Organization | Accounts tracking",
    "version": "2.0",
    "description": "BILL is a cloud-based cash flow management system for an organization's Accounts Payable (AP) and Accounts Receivable (AR) automation.\n * **AP**: Automate workflows to pay vendors bills at scale for the goods and services they provide. Pay vendors with a wide range of payment methods. Generate vendor credits, bill credits, and payment disbursement reports.\n * **AR**: Automate workflows to get paid by customers at scale for the goods and services you provide. Generate and send invoices on a schedule, generate customer and invoice credits, and seamlessly charge authorized customers.\n * **Organization**: Manage your bank accounts (for sending and receiving payments), users (with user roles), and sync with your choice of accounting software.\n\nIntegrate with the BILL API to send and receive payments for your business. See [Support Center](https://help.bill.com/hc/en-us) for resources about using the BILL web app.",
    "contact": {
      "email": "developerprogram@hq.bill.com"
    }
  },
  "servers": [
    {
      "url": "https://api-stage.bill.com/api/v2",
      "description": "Sandbox base URL"
    }
  ],
  "x-readme": {
    "samples-languages": [
      "curl",
      "java",
      "javascript",
      "python",
      "ruby"
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "paths": {
    "/Crud/Update/Location.json": {
      "post": {
        "summary": "Update a location",
        "operationId": "org-accounts-updatelocation",
        "description": "Update a location object.\n\n### What is a location?\nA 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.\n\nIn 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.\n\n### Display location in the BILL web app\nYou can display location numbers with the BILL web app.\n1. In the BILL web app, click **SETTINGS** at the top-right.\n2. Click **Preferences** under **Accounting**.\n3. Click the edit icon at the top-right.\n4. Set **Use Locations** as **Yes** and then click **SAVE**.",
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateLocationResponse"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "required": [
                  "devKey",
                  "sessionId",
                  "data"
                ],
                "properties": {
                  "devKey": {
                    "type": "string",
                    "description": "Developer key generated with your BILL developer account"
                  },
                  "sessionId": {
                    "type": "string",
                    "description": "API session ID generated with [`/v2/Login.json`](ref:auth-login)"
                  },
                  "data": {
                    "$ref": "#/components/schemas/UpdateLocationRequest"
                  }
                }
              }
            }
          }
        },
        "tags": [
          "Locations"
        ]
      },
      "parameters": []
    }
  },
  "components": {
    "schemas": {
      "ErrorResponse": {
        "type": "object",
        "properties": {
          "error_code": {
            "type": "string",
            "description": "Error code (only when `response_status` is `1`)"
          },
          "error_message": {
            "type": "string",
            "description": "Error message (only when `response_status` is `1`)"
          }
        }
      },
      "CreateLocationResponse": {
        "type": "object",
        "properties": {
          "response_status": {
            "type": "integer",
            "description": "Response status.\n* `0`: Success response\n* `1`: Error response. Only `error_code` and `error_message` is returned in `response_data`."
          },
          "response_message": {
            "type": "string",
            "description": "Response status.\n* `Success`: Success response\n* `Error`: Error response. Only `error_code` and `error_message` is returned in `response_data`."
          },
          "response_data": {
            "type": "object",
            "allOf": [
              {
                "$ref": "#/components/schemas/ErrorResponse"
              }
            ],
            "properties": {
              "entity": {
                "type": "string",
                "description": "Object type. Set as `Location`."
              },
              "id": {
                "type": "string",
                "description": "BILL-generated location ID. The value begins with `loc`."
              },
              "shortName": {
                "type": "string",
                "description": "Name for identifying the location in BILL and in your choice of accounting software."
              },
              "isActive": {
                "type": "string",
                "description": "Object visibility status. Inactive objects are hidden by default in the BILL web app.\n* `1`: Active\n* `2`: Inactive"
              },
              "name": {
                "type": "string",
                "description": "Unique location name"
              },
              "parentActgClassId": {
                "type": "string",
                "description": "Parent location ID. Set this value if the current location ID is a child object."
              },
              "description": {
                "type": "string",
                "description": "Location description"
              },
              "createdTime": {
                "type": "string",
                "description": "Created date and time"
              },
              "updatedTime": {
                "type": "string",
                "description": "Updated date and time"
              },
              "mergedIntoId": {
                "type": "string",
                "description": "Parent location ID that the current ID is merged into"
              }
            }
          }
        }
      },
      "UpdateLocationRequest": {
        "type": "object",
        "required": [
          "obj"
        ],
        "properties": {
          "obj": {
            "type": "object",
            "required": [
              "entity",
              "id"
            ],
            "properties": {
              "entity": {
                "type": "string",
                "default": "Location",
                "description": "Object type. Set as `Location`."
              },
              "id": {
                "type": "string",
                "description": "BILL-generated location ID. The value begins with `loc`."
              },
              "name": {
                "type": "string",
                "description": "Unique location name"
              },
              "shortName": {
                "type": "string",
                "description": "Name for identifying the location in BILL and in your choice of accounting software."
              },
              "isActive": {
                "type": "string",
                "description": "Object visibility status. Inactive objects are hidden by default in the BILL web app.\n* `1`: Active\n* `2`: Inactive"
              },
              "parentLocationId": {
                "type": "string",
                "description": "Parent location ID. Set this value if the current location ID is a child object."
              },
              "description": {
                "type": "string",
                "description": "Location description"
              }
            }
          }
        }
      }
    }
  }
}
```