---
title: "Create an Order under a specific Account."
method: POST
path: "/orders"
tags: ["6. Orders"]
---

# Create an Order under a specific Account.

`POST /orders`

## Request body

- CreateOrderCriteria
  - `externalRefID` string — Optional. Idempotent field that can be used for client-side order cross reference and prevent accidental order duplication. Will be returned in order response, order details, and order history.
  - `customerIdentifier` string, required — Specify the customer associated with the order. Must be the customer the accountIdentifier is associated with.
  - `accountIdentifier` string, required — Specify the account this order will be deducted from
  - `utid` string, required — The unique identifier for the reward you are sending as provided in the Get Catalog call
  - `deliveryMethod` 'NONE' | 'EMAIL' | 'PHONE' | 'ADDRESS' | 'EMBEDDED' | 'EMBEDDED_COMPONENT' | 'WHATSAPP', required — Specify delivery method for the order
  - `amount` number, required — Specify the face value of of the reward. Always required, including for fixed value items.
  - `ptid` string — Only required for Printed Reward Links, the unique identifier for the Printed Reward Link Template provided in the Tango Portal on the Printed Template page.
  - `sender` SenderInfoCriteria
    - `firstName` string — always optional (100 character max)
    - `lastName` string — always optional (100 character max)
    - `email` string — always optional
  - `recipient` RecipientInfoCriteria
    - `firstName` string — Required if deliveryMethod is EMAIL, PHONE, or ADDRESS. May be required for some UTIDs. Digital rewards: allows 100 characters, cannot use < or > or / in the name. Physical rewards: allows 25 characters max, Digits 0-9, alpha (a-z, A-Z), space period, comma, ampersand, and hyphen.
    - `lastName` string — Required if deliveryMethod is ADDRESS, otherwise optional. May be required for some UTIDs. Digital rewards: allows 100 characters, cannot use < or > or / in the name. Physical rewards: allows 25 characters max, Digits 0-9, alpha (a-z, A-Z), space period, comma, ampersand, and hyphen.
    - `email` string — Required if deliveryMethod is EMAIL. May be required for some UTIDs. It is useful to include when deliveryMethod is PHONE to easily switch between email and phone delivery
    - `mobileNumber` string — Required if deliveryMethod is PHONE. May be required for some UTIDs. Format: +CCCPPPPPPPPPPPP (where C is the country code, 1-3 digits, and P is the phone number, up to 12 digits). Follows ITU E.164, allowing (+) and up to 15 digits for the combined country code and phone number.
    - `address` AddressCriteria
      - `companyName` string — Optional, Typically used when shipping to a corporate address.
      - `streetLine1` string — Required if deliveryMethod is ADDRESS, not applicable for digital rewards. Allows 35 characters max, not blank, Digits 0-9, alpha (a-z, A-Z), space, period, comma, hyphen, forward slash (/), ampersand, percent, pound (#), at (@), and apostrophe.
      - `streetLine2` string — Optional if deliveryMethod is ADDRESS, not applicable for digital rewards. Allows 35 characters max, not blank, Digits 0-9, alpha (a-z, A-Z), space, period, comma, hyphen, forward slash (/), ampersand, percent, pound (#), at (@), and apostrophe.
      - `city` string — Required if deliveryMethod is ADDRESS, not applicable for digital rewards. Allows 30 characters, not blank, Digits 0-9, alpha (a-z, A-Z), space, period, hyphen, ampersand, and apostrophe.
      - `stateOrProvince` string — Required if deliveryMethod is ADDRESS, not applicable for digital rewards. Address region must be a valid 2-character uppercase abbreviation for a U.S. state, territory, or military base; a Canadian province; or contain an international region less than 36 characters.
      - `postalCode` string — Required if deliveryMethod is ADDRESS, not applicable for digital rewards. Allows 5 characters, not blank, Digits 0-9 and alpha (a-z, A-Z). For US addresses this must include the five digit US ZIP Code only.
      - `country` string — Required if deliveryMethod is ADDRESS, not applicable for digital rewards.
  - `emailSubject` string — Optional. Used with deliveryMethod is EMAIL. The ETID email subject will be used for the specified reward if not specified.
  - `message` string — Optional gift message
  - `sendEmail` boolean — Deprecated Oct 1, 2025. Should Tango Card send the email to the recipient?
  - `etid` string — Optional. Used with deliveryMethod of EMAIL or PHONE. The unique identifier for the electronic template you would like to use. If not specified, the system will use the default etid.
  - `campaign` string — Optional. Campaign that may be used to administratively categorize a specific order. Must be between 0 and 1024 characters in length.
  - `purchaseOrderNumber` string — The Purchase Order Number associated with this order.
  - `notes` string — Optional order notes. Must be between 0 and 1024 characters in length.
  - `expirationDate` string — Optional for Promo Links, the exact calendar date the Promo Link will expire.
  - `customFields` object — Optional. A map of custom field key-value pairs configured at the account level for your platform. Only fields that have been configured for the account are accepted — any fields passed that are not configured will be silently ignored. Fields marked as required in the configuration must be provided; omitting a required field will result in a validation error. Fields marked as optional may be omitted. If no custom fields have been configured for the account, this property can be omitted entirely.

## Response `200`

OK / Existing order found for given external ref ID

- OrderViewSummary
  - `referenceOrderID` string, required
  - `referenceLineItemID` string, required
  - `externalRefID` string, required
  - `customerIdentifier` string, required
  - `accountIdentifier` string, required
  - `amountCharged` MoneyView, required
    - `value` number
    - `currencyCode` string
    - `exchangeRate` number
    - `fee` number
    - `total` number
  - `denomination` MoneyView, required
    - `value` number
    - `currencyCode` string
    - `exchangeRate` number
    - `fee` number
    - `total` number
  - `utid` string, required
  - `ptid` string
  - `rewardName` string, required
  - `reward` RewardView, required
    - `credentials` string, required
    - `credentialList` CredentialView[]
      - `label` string
      - `value` string
      - `type` string
      - `credentialType` string
    - `redemptionInstructions` string
  - `sender` SenderInfoView, required
    - `firstName` string
    - `lastName` string
    - `email` string
  - `recipient` RecipientInfoView, required
    - `firstName` string
    - `lastName` string
    - `email` string
    - `mobileNumber` string
    - `address` RecipientAddressView
      - `companyName` string
      - `streetLine1` string
      - `streetLine2` string
      - `city` string
      - `stateOrProvince` string
      - `postalCode` string
      - `country` string
  - `emailSubject` string, required
  - `message` string, required
  - `sendEmail` boolean
  - `deliveryMethod` 'NONE' | 'EMAIL' | 'PHONE' | 'ADDRESS' | 'EMBEDDED' | 'BULKSHIPMENT' | 'QRCODE' | 'BULKDIGITAL' | 'EMBEDDED_COMPONENT' | 'WHATSAPP'
  - `status` string, required
  - `campaign` string, required
  - `purchaseOrderNumber` string
  - `createdAt` string, required
  - `redemptionInstructions` string

## Other responses

- `201` — Created
- `400` — Bad Request
- `401` — Unauthorized
- `402` — Insufficient Funds
- `403` — Forbidden
- `409` — Conflict; Duplicate Exists
- `422` — Unprocessable Entity
- `429` — Exceeded the allowable TPS rate limit
- `503` — Service Unavailable

---

[API](https://skmtc.net/tangocard/apis/tango-api.md) · [All operations](https://skmtc.net/tangocard/apis/tango-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tangocard/tango-api/revisions/324ad9683921/schema)