Create a marketplace order

Overview

Create a marketplace order when your customer has checked out and Turtles needs to fulfill the item.

Set purchaseOrderNumber to the internal order ID, transaction ID, or associated ID you want to use for future tracking.

Base URL

https://triton.turtles.com

This is the public production API. Turtles does not currently provide a sandbox URL.

Authentication

Order endpoints use HTTP Basic Auth with your Turtles API credentials.

-u "$TURTLES_USER:$TURTLES_PASS"

Endpoint

POST https://triton.turtles.com/api/orders

Partners receive valid itemId values from the product feed provided during onboarding.

Field	Type	Required	Description
`itemId`	number	Yes	Turtles item ID to fulfill.
`purchaseOrderNumber`	string	Yes	Your internal order ID, transaction ID, or associated ID for matching future tracking updates.
`name`	string	Yes	Recipient full name.
`email`	string	Yes	Recipient email address.
`phone`	string	Yes	Recipient phone number, preferably in E.164 format.
`address`	string	Yes	Street address line 1.
`address2`	string	No	Street address line 2.
`city`	string	Yes	Recipient city.
`state`	string	Yes	State or province code.
`zipCode`	string	Yes	Postal code.
`country`	string	Yes	Two-letter country code, for example `US`.

Example

curl -X POST "https://triton.turtles.com/api/orders" \
  -u "$TURTLES_USER:$TURTLES_PASS" \
  -H "Content-Type: application/json" \
  -d '{
    "itemId": 12345,
    "purchaseOrderNumber": "internal-order-1001",
    "name": "Jane Doe",
    "email": "jane@example.com",
    "phone": "+15551234567",
    "address": "123 Main St",
    "address2": "Apt 4B",
    "city": "Austin",
    "state": "TX",
    "zipCode": "78701",
    "country": "US"
  }'

A 201 Created response means Turtles accepted the order. Store the purchaseOrderNumber you sent so you can match future tracking updates.

Automatic retries should reuse the same purchaseOrderNumber. Confirm duplicate-order behavior with Turtles before retrying create requests automatically.

Next, retrieve tracking updates for created orders.

Overview

Build a marketplace

Sell on Turtles

Overview

Base URL

Authentication

Endpoint

Example

​Overview

​Base URL

​Authentication

​Endpoint

​Example

Overview

Base URL

Authentication

Endpoint

Example