Update an existing order

Log in to see full request history

Update an existing order with a PUT request to the resource url.

Use a PUT request to update an order's customer details, carrier and tracking information, delivery status, or price.

Sample Request

The following request uses Standard Carrier Shipping by providing the carrier name and tracking number for a package. Vift tracks the package and sends the video message to the recipient when the carrier marks the package as delivered.

curl -i https://api.vift.com/orders/YOUR_ORDER_ID \ -u YOUR_APP_ID:YOUR_API_KEY \ -H "Content-Type: application/json" \ -X PUT \ -d '{ "carrier": "UPS", "tracking_number": "1Z999AA10123456784" }'

Sample Request

The following request uses Custom Shipment Tracking to mark a package as delivered, which triggers the video message to be sent to the recipient.

curl -i https://api.vift.com/orders/YOUR_ORDER_ID \ -u YOUR_APP_ID:YOUR_API_KEY \ -H "Content-Type: application/json" \ -X PUT \ -d '{ "delivered": 1 }'

Sample Request

The following requests updates the price charged to the customer for the Vift Video Gift Message. For Vift accounts using the revenue share plan, this price is used to calculate your account's monthly billing.

📘

Note: All prices must be in cents.

In the following sample request, the customer was charged $5.50 for the Vift Video Gift Message.

curl -i https://api.vift.com/orders/YOUR_ORDER_ID \ -u YOUR_APP_ID:YOUR_API_KEY \ -H "Content-Type: application/json" \ -X PUT \ -d '{ "price": 550 }'
Path Params
string
required

Order ID

Body Params
string

Name of customer

string

Email of customer

string

Shipping carrier for the package

string

Tracking number of the package

boolean

Status of package delivery

int32

The price, in cents, that was charged to the customer for the Vift order. For accounts using a revenue share payment plan, this price will be used for billing.

Response

Language
Credentials
:
Click Try It! to start a request and see the response here! Or choose an example:
application/json