---
title: "Create Destination"
method: POST
path: "/destinations"
tags: ["Destinations"]
---

# Create Destination

`POST /destinations`

Create a destination.

### Required API key scope
- Destinations (Write)

## Request body

- CreateDestinationRequest
  - `name` string, required — The destination's name.
  - `type` 'warehouse' | 'donate', required — The type of location represented by the destination.
  - `enabled` boolean — Whether the destination is enabled as a return destination.
  - `address` AddressRequest, required — The destination's address.
    - `name` string, nullable — The name associated with the address.
    - `company` string, nullable — The company residing at the address.
    - `address1` string, required — The street address of the destination.
    - `address2` string, nullable — The secondary address details of the destination.
    - `city` string, required
    - `state` string, nullable
    - `zip` string, nullable
    - `country` string, required
    - `country_code` string, required
    - `phone` string, nullable — The phone number associated with the address.

## Response `200`

Success

- Destination — A physical location such as a warehouse or donation center to which returns are shipped.
  - `id` integer — The destination's unique identifier.
  - `type` 'warehouse' | 'donate' — The type of location represented by the destination.
  - `name` string — The destination's name.
  - `enabled` boolean — Whether the destination is enabled as a return destination.
  - `provider_location_id` integer, nullable — The numeric location identifier from the commerce platform (for example Shopify) when a location is linked to this destination in Loop. `null` when no location is linked. The linked location's `source` field indicates which provider the ID belongs to.
  - `address` Address
    - `id` integer
    - `hash` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `name` string
    - `company` string, nullable
    - `address1` string
    - `address2` string
    - `city` string
    - `state` string
    - `zip` string
    - `country` string
    - `country_code` string
    - `phone` string
    - `latitude` number
    - `longitude` number

## Other responses

- `401` — Unauthorized
- `422` — Unprocessable

---

[API](https://skmtc.dev/loopreturns/apis/listings-api.md) · [All operations](https://skmtc.dev/loopreturns/apis/listings-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loopreturns/listings-api/revisions/750e6012dbb8/schema)