Create, pay for, and download an MPP shipping label

The unpaid call persists the exact EasyPost shipment/rate and returns MPP challenges. Retry the identical body with Authorization: Payment. Immediate settlements purchase the persisted rate and return label_download_url in the receipt-bearing response; delayed settlements return 202 and complete through the status endpoint.

post/api/machine/mpp/shipping-labels

Request

  • Base URL: https://postalform.com
  • URL: https://postalform.com/api/machine/mpp/shipping-labels
  • Auth: none required

Request body

request_idstring uuid required

Client-generated idempotency key. Reuse the same value and exact body after a 402 challenge.

buyer_namestring required
buyer_emailstring email required
carrierstring

Optional EasyPost carrier name, for example USPS, UPS, or FedEx.

servicestring

Optional EasyPost carrier service name, for example GroundAdvantage.

Example request

{
  "request_id": "6df12d40-ae2a-4a06-a169-b7aa392ca7bd",
  "buyer_name": "Agent Owner",
  "buyer_email": "owner@example.com",
  "from": {
    "name": "Agent Owner",
    "street1": "417 Montgomery St",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94104",
    "country": "US",
    "phone": "4155550100",
    "email": "owner@example.com"
  },
  "to": {
    "name": "Recipient Example",
    "street1": "179 N Harbor Dr",
    "city": "Redondo Beach",
    "state": "CA",
    "zip": "90277",
    "country": "US",
    "phone": "3105550199"
  },
  "parcel": {
    "weight_oz": 16,
    "length_in": 12,
    "width_in": 9,
    "height_in": 4
  },
  "carrier": "USPS",
  "service": "GroundAdvantage"
}

Response

Payment is complete and the signed PDF label is available

order_idstring uuid required
statusstring required
payment_statusstring required
fulfillment_statusstring required
is_paidboolean required
current_stepstring nullable required
payment_intent_idstring nullable required
payment_channelstring nullable required
currencystring nullable required
product_type'shipping_label' required
carrierstring required
servicestring required
tracking_codestring nullable required
status_urlstring uri required
order_complete_urlstring uri nullable required
label_download_urlstring uri nullable required
label_download_expires_atstring date-time nullable required
errorstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.