Skip to main content
POST
/
destinations
Create Destination
curl --request POST \
  --url https://api.loopreturns.com/api/v1/destinations \
  --header 'Content-Type: application/json' \
  --header 'X-Authorization: <api-key>' \
  --data '
{
  "name": "Example Destination",
  "type": "warehouse",
  "address": {
    "address1": "123 Main St",
    "address2": "Unit 456",
    "city": "Columbus",
    "state": "Ohio",
    "zip": "43210",
    "country": "United States",
    "country_code": "US"
  },
  "enabled": true
}
'
{
  "id": 1,
  "type": "warehouse",
  "name": "Example Destination",
  "enabled": true,
  "provider_location_id": 42424242,
  "address": {
    "address1": "123 Main St",
    "address2": "Unit 456",
    "city": "Columbus",
    "state": "Ohio",
    "zip": "43210",
    "country": "United States",
    "country_code": "US"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.loopreturns.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Authorization
string
header
required

Body

application/json
​
name
string
required

The destination's name.

Example:

"Example Destination"

​
type
enum<string>
required

The type of location represented by the destination.

Available options:
warehouse,
donate
Example:

"warehouse"

​
address
object
required

The destination's address.

​
enabled
boolean

Whether the destination is enabled as a return destination.

Example:

true

Response

Success

A physical location such as a warehouse or donation center to which returns are shipped.

​
id
integer

The destination's unique identifier.

Example:

1

​
type
enum<string>

The type of location represented by the destination.

Available options:
warehouse,
donate
Example:

"warehouse"

​
name
string

The destination's name.

Example:

"Example Destination"

​
enabled
boolean

Whether the destination is enabled as a return destination.

Example:

true

​
provider_location_id
integer | null

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.

Example:

42424242

​
address
object

The destination's address.