---
title: "Update an Async Order under a specific Account."
method: PATCH
path: "/asyncOrders/customers/{customerIdentifier}/accounts/{accountIdentifier}/{externalRefID}"
tags: ["7. Async Orders"]
---

# Update an Async Order under a specific Account.

`PATCH /asyncOrders/customers/{customerIdentifier}/accounts/{accountIdentifier}/{externalRefID}`

## Path parameters

- `customerIdentifier` string, required
- `accountIdentifier` string, required
- `externalRefID` string, required

## Request body

- UpdateAsyncOrderCriteria
  - `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 (up to 150 characters)

## Response `200`

OK

- AsyncOrderDetailView
  - `referenceOrderID` string — Internal reference order ID
  - `externalRefID` string — External reference ID provided by client
  - `orderStatus` string — Current status of the order
  - `createdAt` string, date-time — Order creation timestamp
  - `completedAt` string, date-time — Order completion timestamp
  - `customerIdentifier` string — Customer identifier
  - `accountIdentifier` string — Account identifier
  - `sender` SenderInfoView
    - `firstName` string
    - `lastName` string
    - `email` string
  - `amountCharged` AsyncOrderAmountChargedDTO
    - `currencyCode` string
    - `value` number
    - `total` number
    - `shippingFee` number
  - `campaign` string — Campaign name
  - `purchaseOrderNumber` string — Purchase order number
  - `notes` string — Order notes
  - `totalLineItems` integer — Total number of line items
  - `pagination` PaginationDTO
    - `prevCursor` string
    - `nextCursor` string
    - `prevPageAvailable` boolean
    - `nextPageAvailable` boolean
    - `maxResults` integer
    - `numberOfElements` integer
  - `orderErrors` ErrorDto[] — Order level errors
    - `errorCode` string
    - `errorMessage` string
  - `lineItems` AsyncLineItemView[] — list of line items
    - `referenceLineItemId` string
    - `externalRefLineItemID` string
    - `lineItemStatus` string
    - `deliveryStatus` string
    - `recipient` AsyncUserInfoDTO
      - `firstName` string
      - `lastName` string
      - `email` string
      - `address` AddressDTO
        - `streetLine1` string
        - `streetLine2` string, nullable
        - `city` string
        - `stateOrProvince` string
        - `country` string
        - `postalCode` string
        - `companyName` string
      - `mobileNumber` string
    - `bulkShipping` BulkShippingView
      - `address` BaseAddressView
        - `streetLine1` string
        - `streetLine2` string
        - `city` string
        - `stateOrProvince` string
        - `postalCode` string
        - `country` string
      - `companyName` string
      - `contactFirstName` string
      - `contactLastName` string
      - `contactEmail` string
      - `contactMobileNumber` string
    - `deliveryMethod` 'NONE' | 'EMAIL' | 'PHONE' | 'ADDRESS' | 'EMBEDDED' | 'BULKSHIPMENT' | 'QRCODE' | 'BULKDIGITAL' | 'EMBEDDED_COMPONENT' | 'WHATSAPP'
    - `rewardName` string
    - `quantity` integer
    - `amount` number
    - `amountCharged` MoneyView
      - `value` number
      - `currencyCode` string
      - `exchangeRate` number
      - `fee` number
      - `total` number
    - `scheduledDeliveryDate` string, date-time
    - `lineItemErrors` ErrorDto[]
      - `errorCode` string
      - `errorMessage` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `429` — Exceeded the allowable TPS rate limit
- `500` — Internal Server Error
- `503` — Service Unavailable

---

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