---
title: "Create a shipping location"
method: POST
path: "/companies/{companyId}/shippingLocations"
tags: ["Terminal orders - company level"]
---

# Create a shipping location

`POST /companies/{companyId}/shippingLocations`

## Request

- Base URL: `https://management-test.adyen.com/v3`
- URL: `https://management-test.adyen.com/v3/companies/{companyId}/shippingLocations`
- Auth: one of:
  - HTTP basic
  - API key in header `X-API-Key`

Creates a shipping location for the company identified in the path. A shipping location defines an address where orders can be delivered.

To make this request, your API credential must have the following [role](https://docs.adyen.com/development-resources/api-credentials#api-permissions):
* Management API—Terminal ordering read and write

In the live environment, requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment).

## Path parameters

- `companyId` string, required

## Request body

- ShippingLocation
  - `address` Address
    - `city` string: The name of the city.
    - `companyName` string: The name of the company.
    - `country` string: The two-letter country code, in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
    - `postalCode` string: The postal code.
    - `stateOrProvince` string: The state or province as defined in [ISO 3166-2](https://www.iso.org/standard/72483.html). For example, **ON** for Ontario, Canada. Applicable for the following countries: - Australia - Brazil - Canada - India - Mexico - New Zealand - United States
    - `streetAddress` string: The name of the street, and the house or building number.
    - `streetAddress2` string: Additional address details, if any.
  - `contact` Contact
    - `email` string: The individual's email address.
    - `firstName` string: The individual's first name.
    - `infix` string: The infix in the individual's name, if any.
    - `lastName` string: The individual's last name.
    - `phoneNumber` string: The individual's phone number, specified as 10-14 digits with an optional `+` prefix.
  - `id` string: The unique identifier of the shipping location, for use as `shippingLocationId` when creating an order.
  - `name` string: The unique name of the shipping location.

## Response `200`

OK - the request has succeeded.

- ShippingLocation
  - `address` Address
    - `city` string: The name of the city.
    - `companyName` string: The name of the company.
    - `country` string: The two-letter country code, in [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) format.
    - `postalCode` string: The postal code.
    - `stateOrProvince` string: The state or province as defined in [ISO 3166-2](https://www.iso.org/standard/72483.html). For example, **ON** for Ontario, Canada. Applicable for the following countries: - Australia - Brazil - Canada - India - Mexico - New Zealand - United States
    - `streetAddress` string: The name of the street, and the house or building number.
    - `streetAddress2` string: Additional address details, if any.
  - `contact` Contact
    - `email` string: The individual's email address.
    - `firstName` string: The individual's first name.
    - `infix` string: The infix in the individual's name, if any.
    - `lastName` string: The individual's last name.
    - `phoneNumber` string: The individual's phone number, specified as 10-14 digits with an optional `+` prefix.
  - `id` string: The unique identifier of the shipping location, for use as `shippingLocationId` when creating an order.
  - `name` string: The unique name of the shipping location.

## Other responses

- `400`: Bad Request - a problem reading or understanding the request.
- `401`: Unauthorized - authentication required.
- `403`: Forbidden - insufficient permissions to process the request.
- `422`: Unprocessable Entity - a request validation error.
- `500`: Internal Server Error - the server could not process the request.

---

[API](https://skmtc.dev/adyen/apis/management-api.md) - [All operations](https://skmtc.dev/adyen/apis/management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adyen/apis/management-api/revisions/55cb8143ce0e?raw)