---
title: "Create external order"
method: POST
path: "/open-api/v1.0/external-orders"
tags: ["External Orders"]
---

# Create external order

`POST /open-api/v1.0/external-orders`

*Rate limit: 100 requests / 10 seconds per shop. See [Rate limiting](/guides/rate-limiting).*

Create an externally-paid order for fulfillment. This creates an order where payment was processed on an external marketplace (e.g., Etsy, Amazon) and Fourthwall handles fulfillment. The creator will be charged for fulfillment costs.

## Request body

- ComFourthwallOpenapiModelCreateExternalOrderRequest
  - `externalOrderId` string, required
  - `externalSource` string, required
  - `items` ComFourthwallOpenapiModelExternalOrderItemWithIdRequest[], required
    - `variantId` string, required
    - `quantity` integer, required
    - `externalLineItemId` string
  - `shippingAddress` ComFourthwallOpenapiModelExternalOrderAddressRequest, required
    - `firstName` string, required
    - `lastName` string, required
    - `address1` string, required
    - `address2` string
    - `city` string, required
    - `state` string
    - `zip` string, required
    - `country` string, required
    - `phone` string
  - `billingAddress` ComFourthwallOpenapiModelExternalOrderAddressRequest, required
    - `firstName` string, required
    - `lastName` string, required
    - `address1` string, required
    - `address2` string
    - `city` string, required
    - `state` string
    - `zip` string, required
    - `country` string, required
    - `phone` string
  - `customerEmail` string
  - `metadata` object
  - `taxOverride` 'COLLECT' | 'SKIP' — Admin-only tax treatment override. COLLECT forces tax collection; SKIP forces no tax. Omit to use the default merchant-of-record rules. Honored only for internal Fourthwall admins; any other caller that sets it is rejected.
  - `taxOverrideReason` string — Justification for the override. Required when taxOverride = SKIP.

## Response `201`

Created

- ComFourthwallOpenapiModelExternalOrderV1
  - `orderId` string, uuid, required
  - `externalOrderId` string, required
  - `externalSource` string, required
  - `friendlyId` string, required
  - `status` string, required
  - `items` ComFourthwallOpenapiModelExternalOrderItemV1[], required
    - `offerId` string, uuid, required
    - `variantId` string, uuid, required
    - `quantity` integer, required
    - `externalLineItemId` string
    - `unitCost` Money, required
      - `value` number, required
      - `currency` string, required
    - `totalCost` Money, required
      - `value` number, required
      - `currency` string, required
    - `itemFulfillmentFee` Money, required
      - `value` number, required
      - `currency` string, required
    - `itemShippingCost` Money, required
      - `value` number, required
      - `currency` string, required
    - `itemTotalCreatorCost` Money, required
      - `value` number, required
      - `currency` string, required
  - `shippingAddress` ComFourthwallOpenapiModelExternalOrderAddressV1, required
    - `firstName` string, required
    - `lastName` string, required
    - `address1` string, required
    - `address2` string
    - `city` string, required
    - `state` string
    - `zip` string, required
    - `country` string, required
    - `phone` string
  - `costs` ComFourthwallOpenapiModelExternalOrderCostsV1, required
    - `fulfillmentFee` Money, required
      - `value` number, required
      - `currency` string, required
    - `manufacturingCost` Money, required
      - `value` number, required
      - `currency` string, required
    - `shippingCost` Money, required
      - `value` number, required
      - `currency` string, required
    - `totalCreatorCost` Money, required
      - `value` number, required
      - `currency` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Possible errors: `CHECKOUT_ITEMS_UNAVAILABLE_ERROR`, `CHECKOUT_OFFER_COST_NOT_SET_ERROR`, `CHECKOUT_PROMOTION_ALREADY_USED_BY_CUSTOMER`, `CHECKOUT_PROMOTION_AVAILABLE_ONLY_FOR_SIGNED_CUSTOMERS`, `CHECKOUT_PROMOTION_DOES_NOT_EXISTS`, `CHECKOUT_PROMOTION_FREE_SHIPPING_COUNTRY_NOT_SUPPORTED`, `CHECKOUT_PROMOTION_MAXIMUM_USES_LIMIT_EXCEEDED`, `CHECKOUT_PROMOTION_NOT_ALLOWED_FOR_CUSTOMER_TIER`, `CHECKOUT_PROMOTION_NOT_ALLOWED_FOR_CUSTOMER_TWITCH_TIER`, `CHECKOUT_PROMOTION_NOT_ALLOWED_FOR_GIVEN_ITEMS`, `CHECKOUT_STOCK_NOT_ENOUGH_QUANTITY`, `EXTERNAL_ORDER_COUNTRY_NOT_SUPPORTED`, `EXTERNAL_ORDER_VALIDATION_FAILED`, `EXTERNAL_ORDER_VARIANT_NOT_FOUND`, `GIFT_NOT_FOUND`, `MESSAGE_VALIDATION_ERROR`, `ORDER_ITEMS_NO_LONGER_IN_STOCK_ERROR`, `PAYMENT_FREE_UNAVAILABLE_NON_ZERO`, `PAYMENT_PAYPAL_AUTH_ERROR`, `PAYMENT_PAYPAL_ORDER_NOT_APPROVED`, `PAYMENT_PAYPAL_UNKNOWN_ERROR`, `PAYMENT_PROVIDER_NOT_SUPPORTED`, `PAYMENT_UNPROCESSABLE_PAYPAL_ERROR`, `PROMOTION_ALREADY_USED_BY_CUSTOMER`, `PROMOTION_AVAILABLE_ONLY_FOR_SIGNED_CUSTOMERS`, `PROMOTION_FREE_SHIPPING_COUNTRY_NOT_SUPPORTED`, `PROMOTION_MAXIMUM_USES_LIMIT_EXCEEDED`, `PROMOTION_MISSING_REQUIRED_PRODUCTS`, `PROMOTION_NOT_ALLOWED_FOR_CUSTOMER_TIER`, `PROMOTION_NOT_ALLOWED_FOR_CUSTOMER_TWITCH_TIER`, `PROMOTION_NOT_ALLOWED_FOR_GIVEN_ITEMS`, `SHIPPING_RATES_ERROR`, `UNSUPPORTED_OPERATION_FOR_MANUFACTURER`, `VARIANT_NOT_ALLOWED_FOR_FREE_PRODUCTS`
- `402` — Possible errors: `EXTERNAL_ORDER_NO_PAYMENT_METHOD`
- `404` — Possible errors: `CHECKOUT_SHOP_NOT_FOUND_ERROR`, `CHECKOUT_VARIANT_NOT_FOUND_ERROR`, `DELIVERY_SHOP_NOT_FOUND_ERROR`, `OFFER_NOT_FOUND_ERROR`, `OFFER_VARIANT_NOT_FOUND_ERROR`, `PAYMENT_PAYPAL_TOKEN_EXPIRED`, `PRODUCT_CATALOG_PRODUCT_ID_NOT_FOUND`, `SHOP_TEAM_MEMBER_SHOP_NOT_FOUND_ERROR`, `STOCK_NOT_FOUND`
- `406` — Possible errors: `PAYMENT_INSTRUMENT_DECLINED`
- `409` — Possible errors: `CHECKOUT_PROMOTION_REQUIRE_MINIMUM_ORDER_VALUE`, `EXTERNAL_ORDER_DUPLICATE`, `PROMOTION_REQUIRE_MINIMUM_ORDER_VALUE`
- `422` — Possible errors: `FULFILLMENT_ILLEGAL_STATE_ERROR`
- `429` — Rate limited: 100 requests / 10 seconds per shop.

---

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