Create an Order under a specific Account.
Request body
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.
Specify the customer associated with the order. Must be the customer the accountIdentifier is associated with.
Specify the account this order will be deducted from
The unique identifier for the reward you are sending as provided in the Get Catalog call
Specify delivery method for the order
Specify the face value of of the reward. Always required, including for fixed value items.
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.
Optional. Used with deliveryMethod is EMAIL. The ETID email subject will be used for the specified reward if not specified.
Optional gift message
Deprecated Oct 1, 2025. Should Tango Card send the email to the recipient?
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.
Optional. Campaign that may be used to administratively categorize a specific order. Must be between 0 and 1024 characters in length.
The Purchase Order Number associated with this order.
Optional order notes. Must be between 0 and 1024 characters in length.
Optional for Promo Links, the exact calendar date the Promo Link will expire.
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.
Example request
{
"sendEmail": true,
"etid": "E000000"
}Response
OK / Existing order found for given external ref ID