Skip to content

Fixing a Printful Order

This guide explains how to fix an incorrect Printful order by deleting the existing order, updating the required data, and recreating the order with the correct information.

Step 1: Delete the Existing Printful Order

Delete the incorrect order from Printful before creating the corrected order.

Step 2: Update the Required Data

Update the required order information before recreating the order.

Field Description
external_id Use the CSC Order NR
recipient Verify and update the customer's shipping and contact information
sync_variant_id Use the correct Printful sync variant ID
quantity Set the correct quantity for each item
Item external_id Use the corresponding CSC Order Item ID

Step 3: Create the Corrected Printful Order

Send a POST request to the Printful Orders API.

curl --location 'https://api.printful.com/orders' \
  --header 'X-PF-Store-Id: 16160254' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <PRINTFUL_API_TOKEN>' \
  --body '{
    "recipient": {
        "zip": "<ZIP>",
        "country_code": "US",
        "address2": "",
        "city": "<CITY>",
        "phone": "<PHONE>",
        "address1": "<ADDRESS>",
        "name": "<CUSTOMER NAME>",
        "state_code": "<STATE>",
        "email": "<EMAIL>"
    },
    "external_id": "<CSC ORDER NR>",
    "items": [
        {
            "sync_variant_id": <PRINTFUL SYNC VARIANT ID>,
            "quantity": <QUANTITY>,
            "external_id": "<CSC ORDER ITEM ID>"
        }
    ]
}'

Required Headers

X-PF-Store-Id: 16160254
Content-Type: application/json
Authorization: Bearer <PRINTFUL_API_TOKEN>

!!! warning "Security" Never add a real Printful API token or session cookie to the MkDocs documentation. Use a secure secret or environment variable instead.

Step 4: Verify the Order

After creating the corrected order, verify the following:

  • The Printful order was created successfully.
  • The external_id matches the CSC Order NR.
  • Each item's external_id matches the correct CSC Order Item ID.
  • The recipient and shipping information is correct.
  • The correct sync_variant_id values are being used.
  • The quantities are correct.