---
title: "Create or update dock"
method: POST
path: "/api/logistics/pvt/configuration/docks"
tags: ["Docks"]
---

# Create or update dock

`POST /api/logistics/pvt/configuration/docks`

Creates a new [loading dock](https://help.vtex.com/en/tutorial/loading-dock--5DY8xHEjOLYDVL41Urd5qj) or updates an existing one for your store's [shipping strategy](https://help.vtex.com/en/tutorial/shipping-strategy--58vLBDbjYVQzJ6rRc5QNz3).

## Permissions

Any user or [API key](https://developers.vtex.com/docs/guides/api-authentication-using-api-keys) must have at least one of the appropriate [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3) to be able to successfully run this request. Otherwise they will receive a status code `403` error. These are the applicable resources for this endpoint:

| **Product** | **Category** | **Resource** |
| --------------- | ----------------- | ----------------- |
| Logistics | Logistics access | **Logistics full access** |

You can [create a custom role](https://help.vtex.com/en/tutorial/roles--7HKK5Uau2H6wxE1rH5oRbc#creating-a-role) with that resource or use one of the following [predefined roles](https://help.vtex.com/en/tutorial/predefined-roles--jGDurZKJHvHJS13LnO7Dy):

| **Role** | **Resource** | 
| --------------- | ----------------- | 
| Logistics - Full access | Logistics full access |
| OMS - Full access | Logistics full access |

>❗ Assigning a [predefined role](https://help.vtex.com/en/tutorial/predefined-roles--jGDurZKJHvHJS13LnO7Dy) to users or application keys usually grants permission to multiple [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3). If some of these permissions are not necessary, consider creating a custom role instead. For more information regarding security, see [Best practices for using application keys](https://help.vtex.com/en/tutorial/best-practices-api-keys--7b6nD1VMHa49aI5brlOvJm). To learn more about machine authentication at VTEX, see [Authentication overview](https://developers.vtex.com/docs/guides/authentication).

## Headers

- `Content-Type` string, required
- `Accept` string, required

## Request body

- object
  - `id` string, required — [Loading dock](https://help.vtex.com/en/tutorial/loading-dock--5DY8xHEjOLYDVL41Urd5qj) ID.
  - `name` string, required — Loading dock name.
  - `priority` integer, required — Value used as a tie-breaking rule when selecting a loading dock.
  - `dockTimeFake` string, required — [Loading dock](https://help.vtex.com/en/tutorial/loading-dock--5DY8xHEjOLYDVL41Urd5qj) processing time in the format `D.HH:MM:SS`. When not configured, it returns `00:00:00`.
  - `timeFakeOverhead` string, required — Time frame used to choose a loading dock when there is more than one loading dock with the same processing time. The lower the value entered in this field, the greater the possibility of the loading dock being chosen. >ℹ️ This field is not considered when calculating the delivery time.
  - `salesChannels` string[], required — Sales channels ([trade policies](https://help.vtex.com/en/tutorial/how-trade-policies-work--6Xef8PZiFm40kg2STrMkMV)) to associate with the loading dock.
  - `salesChannel` string, required — Main sales channel ([trade policy](https://help.vtex.com/en/tutorial/how-trade-policies-work--6Xef8PZiFm40kg2STrMkMV)) to associate with the loading dock.
  - `freightTableIds` string[], required — List with freight table IDs.
  - `wmsEndPoint` string, nullable, required — Warehouse Management System (WMS) fulfillment endpoint.
  - `address` object, required — Dock address object.
    - `postalCode` string, required — Dock address postal code.
    - `country` object, required — Dock address country object.
      - `acronym` string, required — Three letter ISO code for the dock address country.
      - `name` string, required — Dock address country name.
    - `city` string, required — Dock address city.
    - `state` string, required — Dock address state.
    - `neighborhood` string, required — Dock address neighborhood.
    - `street` string, required — Dock address street.
    - `number` string, required — Dock address number.
    - `complement` string, required — Dock address complement.
    - `coordinates` array[], required — Dock address geolocation coordinates.
      - number[] — Geolocation coordinates, first longitude then latitude.

## Response `200`

OK

- boolean — Successful requests return the message `true`.

---

[API](https://skmtc.net/vtex/apis/logistics-api.md) · [All operations](https://skmtc.net/vtex/apis/logistics-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vtex/logistics-api/revisions/c08af805d8b3/schema)