> This page is for Data API, version v2 (default). > For other versions, use one of these documentation indexes: > - v2 (default): https://developers.webflow.com/data/v2.0.0/llms.txt > - v2 Beta: https://developers.webflow.com/data/v2.0.0-beta/llms.txt > - v1: https://developers.webflow.com/data/v1.0.0/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developers.webflow.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.webflow.com/_mcp/server. # New eComm Order POST Information about a new ecommerce order Reference: https://developers.webflow.com/data/reference/webhooks/events/ecomm-new-order ## Request ### Payload - `triggerType` (string, optional) — The type of event that triggered the request - `payload` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayload, optional) ## Types ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayload - `orderId` (string, optional) — The order ID. Will usually be 6 hex characters, but can also be 9 hex characters if the site has a very large number of Orders. Randomly assigned. - `status` (enum, optional) — The status of the Order - Allowed values: `pending`, `unfulfilled`, `fulfilled`, `disputed`, `dispute-lost`, `refunded` - `comment` (string, optional) — A comment string for this Order, which is editable by API user (not used by Webflow). - `orderComment` (string, optional) — A comment that the customer left when making their Order - `acceptedOn` (string, optional, nullable) — The ISO8601 timestamp that an Order was placed. - `fulfilledOn` (string, optional, nullable) — When an Order is marked as 'fulfilled', this field represents the timestamp of the fulfillment in ISO8601 format. Otherwise, it is null. - `refundedOn` (string, optional, nullable) — When an Order is marked as 'refunded', this field represents the timestamp of the fulfillment in ISO8601 format. Otherwise, it is null. - `disputedOn` (string, optional, nullable) — When an Order is marked as 'disputed', this field represents the timestamp of the fulfillment in ISO8601 format. Otherwise, it is null. - `disputeUpdatedOn` (string, optional, nullable) — If an Order has been disputed by the customer, this key will be set to the ISO8601 timestamp of the last update received. If the Order is not disputed, the key will be null. - `disputeLastStatus` (enum, optional, nullable) — If an order was disputed by the customer, then this key will be set with the [dispute's status](https://stripe.com/docs/api#dispute_object-status). - Allowed values: `warning_needs_response`, `warning_under_review`, `warning_closed`, `needs_response`, `under_review`, `charge_refunded`, `won`, `lost` - `customerPaid` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadCustomerPaid, optional) — The total paid by the customer - `netAmount` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadNetAmount, optional) — The net amount after application fees - `applicationFee` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadApplicationFee, optional) — The application fee assessed by the platform - `allAddresses` (list of WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadAllAddressesItems, optional) — All addresses provided by the customer during the ordering flow. - `shippingAddress` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadShippingAddress, optional) — The shipping address - `billingAddress` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadBillingAddress, optional) — The billing address - `shippingProvider` (string, optional, nullable) — A string editable by the API user to note the shipping provider used (not used by Webflow). - `shippingTracking` (string, optional, nullable) — A string editable by the API user to note the shipping tracking number for the order (not used by Webflow). - `shippingTrackingURL` (string, optional, nullable) - `customerInfo` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadCustomerInfo, optional) — An object with the keys `fullName` and `email`. - `purchasedItems` (list of WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadPurchasedItemsItems, optional) — An array of all things that the Customer purchased. - `purchasedItemsCount` (double, optional) — The sum of all 'count' fields in 'purchasedItems'. - `stripeDetails` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadStripeDetails, optional) — An object with various Stripe IDs, useful for linking into the stripe dashboard. - `stripeCard` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadStripeCard, optional) — Details on the card used to fulfill this order, if this order was finalized with Stripe. - `paypalDetails` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadPaypalDetails, optional) - `customData` (list of WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadCustomDataItems, optional) — An array of additional inputs for custom order data gathering. Each object in the array represents an input with a name, and a textInput, textArea, or checkbox value. - `metadata` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadMetadata, optional) - `isCustomerDeleted` (boolean, optional) — A boolean indicating whether the customer has been deleted from the site. - `isShippingRequired` (boolean, optional) — A boolean indicating whether the order contains one or more purchased items that require shipping. - `hasDownloads` (boolean, optional) — A boolean indicating whether the order contains one or more purchased items that are downloadable. - `paymentProcessor` (string, optional) — A string indicating the payment processor used for this order. - `totals` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadTotals, optional) — An object describing various pricing totals - `downloadFiles` (list of WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadDownloadFilesItems, optional, default: []) — An array of downloadable file objects. ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadCustomerPaid The total paid by the customer - `unit` (string, optional) — The three-letter ISO currency code - `value` (string, optional) — The numeric value in the base unit of the currency - `string` (string, optional) — The user-facing string representation of the amount ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadNetAmount The net amount after application fees - `unit` (string, optional) — The three-letter ISO currency code - `value` (string, optional) — The numeric value in the base unit of the currency - `string` (string, optional) — The user-facing string representation of the amount ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadApplicationFee The application fee assessed by the platform - `unit` (string, optional) — The three-letter ISO currency code - `value` (string, optional) — The numeric value in the base unit of the currency - `string` (string, optional) — The user-facing string representation of the amount ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadAllAddressesItems A customer address - `type` (enum, optional) — The type of the order address (billing or shipping) - Allowed values: `shipping`, `billing` - `japanType` (enum, optional, nullable) — Represents a Japan-only address format. This field will only appear on orders placed from Japan. - Allowed values: `kana`, `kanji` - `addressee` (string, optional) — Display name on the address - `line1` (string, optional) — The first line of the address - `line2` (string, optional) — The second line of the address - `city` (string, optional) — The city of the address. - `state` (string, optional) — The state or province of the address - `country` (string, optional) — The country of the address - `postalCode` (string, optional) — The postal code of the address ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadShippingAddress The shipping address - `type` (enum, optional) — The type of the order address (billing or shipping) - Allowed values: `shipping`, `billing` - `japanType` (enum, optional, nullable) — Represents a Japan-only address format. This field will only appear on orders placed from Japan. - Allowed values: `kana`, `kanji` - `addressee` (string, optional) — Display name on the address - `line1` (string, optional) — The first line of the address - `line2` (string, optional) — The second line of the address - `city` (string, optional) — The city of the address. - `state` (string, optional) — The state or province of the address - `country` (string, optional) — The country of the address - `postalCode` (string, optional) — The postal code of the address ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadBillingAddress The billing address - `type` (enum, optional) — The type of the order address (billing or shipping) - Allowed values: `shipping`, `billing` - `japanType` (enum, optional, nullable) — Represents a Japan-only address format. This field will only appear on orders placed from Japan. - Allowed values: `kana`, `kanji` - `addressee` (string, optional) — Display name on the address - `line1` (string, optional) — The first line of the address - `line2` (string, optional) — The second line of the address - `city` (string, optional) — The city of the address. - `state` (string, optional) — The state or province of the address - `country` (string, optional) — The country of the address - `postalCode` (string, optional) — The postal code of the address ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadCustomerInfo An object with the keys `fullName` and `email`. - `fullName` (string, optional) — The full name of the Customer - `email` (string, optional) — The Customer's email address ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadPurchasedItemsItems An Item that was purchased - `count` (double, optional) — Number of Item purchased. - `rowTotal` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadPurchasedItemsItemsRowTotal, optional) — The total for the row - `productId` (string, optional) — The unique identifier for the Product - `productName` (string, optional) — User-facing name of the Product - `productSlug` (string, optional) — Slug for the Product - `variantId` (string, optional) — Identifier for the Product Variant (SKU) - `variantName` (string, optional) — User-facing name of the Product Variant (SKU) - `variantSlug` (string, optional) — Slug for the Product Variant (SKU) - `variantSKU` (string, optional) — The user-defined custom SKU of the Product Variant (SKU) - `variantImage` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadPurchasedItemsItemsVariantImage, optional) - `variantPrice` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadPurchasedItemsItemsVariantPrice, optional) — The price corresponding to the variant - `weight` (double, optional, nullable) — The physical weight of the variant if provided, or null - `width` (double, optional, nullable) — The physical width of the variant if provided, or null - `height` (double, optional, nullable) — The physical height of the variant if provided, or null - `length` (double, optional, nullable) — The physical length of the variant if provided, or null ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadStripeDetails An object with various Stripe IDs, useful for linking into the stripe dashboard. - `subscriptionId` (string, optional, nullable) — Stripe-generated identifier for the Subscription - `paymentMethod` (string, optional, nullable) — Stripe-generated identifier for the PaymentMethod used - `paymentIntentId` (string, optional, nullable) — Stripe-generated identifier for the PaymentIntent, or null - `customerId` (string, optional, nullable) — Stripe-generated customer identifier, or null - `chargeId` (string, optional, nullable) — Stripe-generated charge identifier, or null - `disputeId` (string, optional, nullable) — Stripe-generated dispute identifier, or null - `refundId` (string, optional, nullable) — Stripe-generated refund identifier, or null - `refundReason` (string, optional, nullable) — Stripe-generated refund reason, or null ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadStripeCard Details on the card used to fulfill this order, if this order was finalized with Stripe. - `last4` (string, optional) — The last 4 digits on the card as a string - `brand` (enum, optional) — The card's brand (ie. credit card network) - Allowed values: `Visa`, `American Express`, `MasterCard`, `Discover`, `JCB`, `Diners Club`, `Unknown` - `ownerName` (string, optional) — The name on the card. - `expires` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadStripeCardExpires, optional) — The card's expiration date. ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadPaypalDetails - `orderId` (string, optional) — PayPal order identifier - `payerId` (string, optional) — PayPal payer identifier - `captureId` (string, optional) — PayPal capture identifier - `refundId` (string, optional) — PayPal refund identifier - `refundReason` (string, optional) — PayPal-issued reason for the refund - `disputeId` (string, optional) — PayPal dispute identifier ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadCustomDataItems ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadMetadata - `isBuyNow` (boolean, optional) ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadTotals An object describing various pricing totals - `subtotal` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadTotalsSubtotal, optional) — The subtotal price - `extras` (list of WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadTotalsExtrasItems, optional) — An array of extra items, includes discounts, shipping, and taxes. - `total` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadTotalsTotal, optional) — The total price ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadDownloadFilesItems - `id` (string, optional) — The unique identifier for the downloadable file - `name` (string, optional) — The user-facing name for the downloadable file - `url` (string, optional) — The hosted location for the downloadable file ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadPurchasedItemsItemsRowTotal The total for the row - `unit` (string, optional) — The three-letter ISO currency code - `value` (string, optional) — The numeric value in the base unit of the currency - `string` (string, optional) — The user-facing string representation of the amount ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadPurchasedItemsItemsVariantImage - `url` (string, optional) — The hosted location for the Variant's image - `file` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadPurchasedItemsItemsVariantImageFile, optional) ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadPurchasedItemsItemsVariantPrice The price corresponding to the variant - `unit` (string, optional) — The three-letter ISO currency code - `value` (string, optional) — The numeric value in the base unit of the currency - `string` (string, optional) — The user-facing string representation of the amount ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadStripeCardExpires The card's expiration date. - `year` (double, optional) — Year that the card expires - `month` (double, optional) — Month that the card expires ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadTotalsSubtotal The subtotal price - `unit` (string, optional) — The three-letter ISO currency code - `value` (string, optional) — The numeric value in the base unit of the currency - `string` (string, optional) — The user-facing string representation of the amount ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadTotalsExtrasItems Extra order items, includes discounts, shipping, and taxes. - `type` (enum, optional) — The type of extra item this is. - Allowed values: `discount`, `discount-shipping`, `shipping`, `tax` - `name` (string, optional) — A human-readable (but English) name for this extra charge. - `description` (string, optional) — A human-readable (but English) description of this extra charge. - `price` (WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadTotalsExtrasItemsPrice, optional) — The price for the item ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadTotalsTotal The total price - `unit` (string, optional) — The three-letter ISO currency code - `value` (string, optional) — The numeric value in the base unit of the currency - `string` (string, optional) — The user-facing string representation of the amount ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadPurchasedItemsItemsVariantImageFile - `size` (double, optional) — The image size in bytes - `originalFileName` (string, optional) — the original name of the image - `createdOn` (string, optional) — The creation timestamp of the image - `contentType` (string, optional) — The MIME type of the image - `width` (integer, optional) — The image width in pixels - `height` (integer, optional) — The image height in pixels - `variants` (list of WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadPurchasedItemsItemsVariantImageFileVariantsItems, optional) — Variants of the supplied image ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadTotalsExtrasItemsPrice The price for the item - `unit` (string, optional) — The three-letter ISO currency code - `value` (string, optional) — The numeric value in the base unit of the currency - `string` (string, optional) — The user-facing string representation of the amount ### WebhooksEcommNewOrderPayloadContentApplicationJsonSchemaPayloadPurchasedItemsItemsVariantImageFileVariantsItems - `url` (string, optional) — The hosted location for the Variant's image - `originalFileName` (string, optional) - `size` (double, optional) — The image size in bytes - `width` (integer, optional) — The image width in pixels - `height` (integer, optional) — The image height in pixels