---
title: "Create Location"
method: POST
path: "/accounting/locations"
tags: ["Locations"]
---

# Create Location

`POST /accounting/locations`

Create Location

## Query parameters

- `raw` boolean

## Headers

- `x-apideck-consumer-id` string, required
- `x-apideck-app-id` string, required
- `x-apideck-service-id` string
- `x-apideck-company-id` string

## Request body

- AccountingLocation
  - `id` string — A unique identifier for an object.
  - `parent_id` string, nullable — A unique identifier for an object.
  - `display_id` string, nullable — Id to be displayed.
  - `downstream_id` string, nullable — The third-party API ID of original entity
  - `company_name` string, nullable — The name of the company.
  - `display_name` string, nullable — The display name of the location.
  - `status` 'active' | 'inactive' — Based on the status some functionality is enabled or disabled.
  - `addresses` Address[]
    - `id` string, nullable — Unique identifier for the address.
    - `type` 'primary' | 'secondary' | 'home' | 'office' | 'shipping' | 'billing' | 'work' | 'other', nullable — The type of address.
    - `string` string, nullable — The address string. Some APIs don't provide structured address data.
    - `name` string, nullable — The name of the address.
    - `line1` string, nullable — Line 1 of the address e.g. number, street, suite, apt #, etc.
    - `line2` string, nullable — Line 2 of the address
    - `line3` string, nullable — Line 3 of the address
    - `line4` string, nullable — Line 4 of the address
    - `line5` string, nullable — Line 5 of the address
    - `street_number` string, nullable — Street number
    - `city` string, nullable — Name of city.
    - `state` string, nullable — Name of state
    - `postal_code` string, nullable — Zip code or equivalent.
    - `country` string, nullable — country code according to ISO 3166-1 alpha-2.
    - `latitude` string, nullable — Latitude of the address
    - `longitude` string, nullable — Longitude of the address
    - `county` string, nullable — Address field that holds a sublocality, such as a county
    - `contact_name` string, nullable — Name of the contact person at the address
    - `salutation` string, nullable — Salutation of the contact person at the address
    - `phone_number` string, nullable — Phone number of the address
    - `fax` string, nullable — Fax number of the address
    - `email` string, nullable — Email address of the address
    - `website` string, nullable — Website of the address
    - `notes` string, nullable — Additional notes
    - `row_version` string, nullable — A binary value used to detect updates to a object and prevent data conflicts. It is incremented each time an update is made to the object.
  - `subsidiaries` SubsidiaryReference[]
    - `id` string — A unique identifier for an object.
    - `name` string, nullable — The name of the company.
  - `custom_mappings` CustomMappings, nullable — When custom mappings are configured on the resource, the result is included here.
  - `row_version` string, nullable — A binary value used to detect updates to a object and prevent data conflicts. It is incremented each time an update is made to the object.
  - `updated_by` string, nullable — The user who last updated the object.
  - `created_by` string, nullable — The user who created the object.
  - `updated_at` string, date-time, nullable — The date and time when the object was last updated.
  - `created_at` string, date-time, nullable — The date and time when the object was created.
  - `pass_through` object[] — The pass_through property allows passing service-specific, custom data or structured modifications in request body when creating or updating resources.
    - `service_id` string, required — Identifier for the service to which this pass_through should be applied.
    - `operation_id` string — Optional identifier for a workflow operation to which this pass_through should be applied. This is useful for Unify calls that are making more than one downstream request.
    - `extend_object` object — Simple object allowing any properties for direct extension.
    - `extend_paths` object[] — Array of objects for structured data modifications via paths.
      - `path` string, required — JSONPath string specifying where to apply the value.
      - `value` unknown, required

## Response `201`

Location

- CreateAccountingLocationResponse
  - `status_code` integer, required — HTTP Response Status Code
  - `status` string, required — HTTP Response Status
  - `service` string, required — Apideck ID of service provider
  - `resource` string, required — Unified API resource name
  - `operation` string, required — Operation performed
  - `data` UnifiedId, required — A object containing a unique identifier for the resource that was created, updated, or deleted.
    - `id` string, required — The unique identifier of the resource
  - `_raw` Raw, nullable — Raw response from the integration when raw=true query param is provided

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `404` — The specified resource was not found
- `422` — Unprocessable
- `default` — Unexpected error

---

[API](https://skmtc.net/apideck-libraries/apis/accounting-api.md) · [All operations](https://skmtc.net/apideck-libraries/apis/accounting-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apideck-libraries/accounting-api/versions/33e09b023d02/schema)