Release Notes

New Release: Wix eCommerce Abandoned Checkouts API

Wix eCommerce introduces the new Abandoned Checkouts API. When a customer begins an eCommerce Checkout process but doesn't complete it (for example, after closing their browser tab before putting in their payment details and making a payment), that checkout becomes an abandoned checkout.

The Abandoned Checkouts API allows an app developer to help a customer recover their abandoned checkout (return to their incomplete checkout and complete the checkout).

The Abandoned Checkouts API provides the following functionalities:

• Get an abandoned checkout.
• Query abandoned checkouts.
• An event when an abandoned checkout is created.
• An event when an abandoned checkout is recovered.

(June 6, 2023)

New Webhooks: Wix Bookings V2

The Bookings V2 API now includes new webhooks for helping you manage the booking process flow:

• Booking Created
• Booking Rescheduled
• Booking Confirmed
• Booking Declined
• Booking Canceled
• Number of Participants Updated

(May 30, 2023)

New Release: Bookings Service Options and Variants

The Bookings Service Options and Variants API enables you to retrieve and manage options and variants for a particular bookings service. The new API includes:

• Get Service Options And Variants
• Get Service Options And Variants By Service ID
• Query Service Options And Variants
• Create Service Options And Variants
• Clone Service Options And Variants
• Update Service Options And Variants
• Delete Service Options And Variants
• Webhooks:
  • Service Options And Variants Created
  • Service Options And Variants Updated
  • Service Options And Variants Deleted

(May 22, 2023)

New Functionality: Wix Blocks

3rd party apps can now be written partially or completely using Wix Blocks, powered by Velo by Wix. See Publishing your Blocks app to the App Market for details.

(May 22, 2023)

New Release: Redirect Session

The Redirect Session API enables you to manage redirection of site visitors between external Wix Headless client sites and Wix-managed pages for processes such as authentication and checkout. The new API includes:

• Create Redirect Session

(April 30, 2023)

New Release: Event Guests

The Event Guests API enables you to manage guests for a particular event. The new API includes:

• Query Event Guests

(April 25, 2023)

New Release: Wix eCommerce Additional Fees Integration SPI

The new Calculate Additional Fees endpoint provides third parties the ability to calculate various additional fees for items in a cart, checkout, or order.

(April 13, 2023)

New Release: Wix Data API

The Wix Data API provides a complete solution for accessing, organizing, configuring, and managing data stored in a Wix project or site's database. It includes the following APIs:

• Data Items: Access and manage items in a Wix site's data collections.
• Data Collections: Create data collections and manage their structure.
• Indexes: Create indexes for data collections, to make querying data faster.
• External Database Connections: Connect an external database and manage it with Wix Data APIs.

(April 13, 2023)

New Release: OAuth Apps API

The OAuth Apps API API enables you to create and manage OAuth apps which authorize external apps or sites to access a Wix project or site's data. It includes the following endpoints:

• Create OAuth App
• Delete OAuth App
• Get OAuth App
• Query OAuth Apps
• Update OAuth App

(April 02, 2023)

New Endpoints: Wix Media

The Media API now includes new endpoints and webhooks:

• Update File Descriptor updates a file. This replaces Update File which has been deprecated and will be removed on March 31, 2023.
• List Files retrieves a list of files in the Media Manager.
• List Deleted Files retrieves a list of files in the Media Manager's trash bin.
• List Folders retrieves a list of folders in the Media Manager's trash bin.
• List Deleted Folders retrieves a list of folders in the Media Manager's trash bin.
• File Ready Webhook triggered when a file is ready to be used, after any post-upload processing.
• File Failed Webhook triggered when a file fails during essential post-upload processing.
• File Descriptor Updated Webhook triggered when a file is updated, including when a file is moved to a different folder.
• File Descriptor Deleted Webhook triggered when a file is deleted.
• Folder Created Webhook triggered when a folder is created.
• Folder Updated Webhook triggered when a folder is updated.
• Folder Deleted Webhook triggered when a folder is deleted.

(March 30, 2023)

New Releases: Wix Bookings Pricing API and Pricing Integration SPI

The new Wix Bookings Pricing APIs and Pricing Integration SPI provide third parties the ability to preview, calculate, and customize pricing for bookings:

• Preview how much a booking will cost based on its line items.
• Calculate how much a booking will cost based on either:
  • Standard pricing logic supplied with Wix Bookings.
  • Custom pricing, that you implement.
• Integrate your own custom pricing logic, such as varied pricing, into Wix Bookings with the Pricing Integration SPI.

(March 28, 2023)

New Release: eCommerce Order Fulfillments

The eCommerce Order Fulfillments API provides third parties the ability to manage eCommerce order fulfillments. The new API includes:

• Create Fulfillment
• Bulk Create Fulfillments
• Update Fulfillment
• List Fulfillments For Single Order
• List Fulfillments For Multiple Orders
• Delete Fulfillment

(March 13, 2023)

New Release: External Calendars V2

The External Calendars V2 API enables you to connect and sync a Wix site with external calendars. The new API includes the following endpoints:

• Connect By Credentials
• Connect By OAuth
• Disconnect
• Get Connection
• List Calendars
• List Connections
• List Events
• List Providers
• Update Sync Config

(March 02, 2023)

New Release: Policies v2

The Policies v2 API enables you to manage the policies for a particular event. The new API includes:

• Create Policy
• Delete Policy
• Get Policy
• Query Policies
• Reorder Event Policies
• Update Policy

(March 01, 2023)

New Release: Bookings Services

The Bookings Services V2 API provides third parties the ability to retrieve information about services using the Get Service and Query Services APIs.

(February 27, 2023)

New Endpoints: Wix eCommerce

The Wix eCommerce Cart API now includes 8 new endpoints:

• Create Checkout From Cart.
• Estimate Totals.
• Add To Cart.
• Update Cart.
• Update Line Items.
• Remove Coupon.
• Remove Line Items.
• Delete Cart.

(February 27, 2023)

New Endpoints: Contacts API

The Contacts API now includes two new endpoints:

• Merge Contacts allows you to merge one or more source contacts into a target contact. Note that a successful merge deletes the source contacts and updates the target contact.
• Preview Merge Contacts allows you to perform a dry run of a merge without deleting or updating contacts.

New Release: Wix Notifications

The new Wix Notifications API enables you to trigger the sending of predefined notifications to Wix site owners and contributors. Create a notification in the Wix Dev Center, then call the Notify endpoint to send notifications.

(February 26, 2023)

New Endpoint: Bookings Calendar API

The Wix Bookings Calendar API now includes a new endpoint:

• Query Sessions retrieves a list of sessions, given provided time range, filtering, and paging. This replaces List Sessions which has been deprecated and will be removed on June 30, 2023.

(February 23, 2023)

New Release: Site Actions

Account Level APIs has a new Site Actions API that enables you to manage sites. The new API introduces the Bulk Delete Site endpoint.

As with other Account Level APIs, Site Actions APIs are accessible only using API keys.

(January 25, 2023)

New Release: Wix eCommerce

Wix eCommerce introduces new APIs functionality that enables you to read eCommerce cart, checkout, and order information, as well as listen to webhooks. The new APIs includes:

• Cart API.
• Checkout API.
• Order API.

(January 22, 2023)

New Release: Pro Gallery

Site Content has a new Pro Gallery API.

The Pro Gallery API enables 3rd-parties to view and manage pro galleries on a Wix site's backend. The new API includes:

• Creating a gallery.
• Creating a gallery item.
• List Galleries.
• List Gallery items.

(January 17, 2023)

New Release: Media

The new Media API enables 3rd-parties to view and manage content in the Media Manager such as:

• Importing a file to the Media Manager.
• Generating a video streaming URL.
• Searching for a file in the Media Manager.
• Creating a new folder in the Media Manager.
• Getting a folder from the Media Manager.

(January 17, 2023)

New Release: Wix Automations

The new Wix Automations API introduces configuration options for you to become a trigger provider. As a trigger provider, your custom triggers and trigger payloads are installed with your app, allowing site collaborators to create automations triggered by events you report and control.

(January 15, 2023)

New Release: Wix Blog

The Blog API introduces new write functionality:

• The new Draft Posts APIs enable you to create, delete, and manage blog draft posts.
• You can now manage blog categories using the Categories APIs, such as Create Category, Update Category, and Delete Category.
• You can now manage blog tags using the Tags APIs, such as Create Tag and Delete Tag.

Some Blog API parameters and properties have been renamed. The existing parameters and properties are deprecated and will be removed on June 30, 2023.

(Dec 20, 2022)

New Fields: Restaurants Orders API

The Order object has new fields:

• The new discounts.catalogDiscountDescription field is the discount description as defined in the catalog.
• The new lineItems.dishOptions.name field is the line item option name.
• The new loyaltyInfo.estimatedAccountBalance field is the Wix Loyalty estimated account balance.
• The new loyaltyInfo.estimatedPointsEarned field is the Wix Loyalty estimated total earned points.
• The new loyaltyInfo.rewardRevision field is the Wix Loyalty reward revision number.

(December 13, 2022)

New Data: App Instance API

• The copiedFromTemplate parameter replaces the deprecated isOriginSiteTemplate parameter.
• The siteId parameter is Wix's internal unique site identifier.

(November 6, 2022)

New Endpoints: Coupons API

The Coupons API now includes two new endpoints:

• Bulk Create Coupons allows for creating multiple coupons with one API call.
• Bulk Delete Coupons allows for deleting multiple coupons with one API call.

(October 26, 2022)

New Webhook: Email Marketing API

The Email Activity Updated Webhook is triggered each time an email campaign has a new recipient activity.

(October 19, 2022)

New Webhooks: Members API

The Members Badges API now includes these new webhooks:

• Badge Created is triggered when a badge is created.
• Badge Updated is triggered when a badge is updated.
• Badge Assigned and Badge Unassigned are triggered when a badge is assigned to, or unassigned from, a member.
• Badge Deleted is triggered when a badge is deleted.

(September 22, 2022)

New Webhooks: Pricing Plans API

The Pricing Plans Orders API now includes these new webhooks:

• Order Created and Order Purchased are triggered when an order is created or purchased.
• Order Started and Order Cycle Started are triggered at the start of a new order or a new order cycle.
• Order Marked As Paid is triggered when an offline order is marked as paid.
• Order End Date Postponed, Order Paused and Order Resumed are triggered when an order is postponed, paused, or resumed.
• Order Canceled and Order Auto Renew Canceled are triggered when an order is canceled.
• Order Ended is triggered when an order ends.
• Order Updated is triggered when an order is updated.

(September 6, 2022)

New Endpoints: Email Marketing API

The Email Marketing API now includes two new endpoints:

• List Recipients retrieves a list of recipients for a selected campaign based on a specific recipient activity.
• List Statistics retrieves a list of detailed statistics for selected campaigns.

(September 5, 2022)

New Webhooks: Members API

The Members API now includes three new webhooks:

• Member Created is triggered when a member is created.
• Member Deleted is triggered when a member is deleted.
• Member Updated is triggered when a member is updated.

These webhooks complement the existing Members endpoints. (September 1, 2022)

New Endpoints: Site Properties API

The Site Properties API now includes three new endpoints:

• Update Business Contact updates a site's business contact information.
• Update Business Profile updates a site's business profile.
• Update Business Schedule updates a site's business schedule.

These endpoints complement the existing Update Consent Policy endpoint.

(August 17, 2022)

New Release: Pricing Plans Orders API

The Pricing Plans Orders API provides third parties the ability to manage a site's pricing plan orders, as well as create offline orders.

(July 20, 2022)

New Release: Wix Loyalty Program

The Wix Loyalty Program API provides third parties the ability to activate and manage a site's loyalty program. This includes creating and adjusting customer loyalty accounts.

(July 14, 2022)

New Releases: Stores Catalog API

New and Updated APIs

• The new Bulk Update Products introduces bulk functionality for updating/setting a certain field for up to 100 products at a time.
• The new Bulk Adjust Product Properties allows for bulk adjusting a certain numerical property (price, cost, or weight) for up to 100 products at a time.
• The new Remove Brand introduces functionality for deleting a product's brand.
• The new Remove Ribbon introduces functionality for deleting a product's ribbon. Ribbons can be used to draw attention to products you want to promote.

New Data

• A new query param was added to the Get Product API - includeMerchantSpecificData. This boolean determines whether merchant specific data, such as cost and profit data, is included in the response.
• A new query param was added to the Get Collection API - includeNumberOfProducts. This boolean determines whether a field named numberOfProducts is included in the response.
• The new product.costAndProfitData field holds information about a product's cost of goods, profit, and margin. Learn more about calculating the cost of goods for a product.
• The new product.costRange, product.weightRange, and product.priceRange fields hold information about the minimum and maximum values of each. For example, the lightest and heaviest products/variants in a store's catalog.

(July 14, 2022)

New Release: Restaurants Local Delivery Integration SPI

The new Restaurants Local Delivery SPI introduces the ability to integrate third-party local delivery services with a Wix site. Local delivery services include estimating and creating deliveries.

New to working with Wix SPIs? Learn more

(June 30, 2022)

New Release: Wix Blog Tags

The new Blog Tags API introduces read functionality for blog tags.

(April 25, 2022)

New Webhook: Restaurants Orders API

The new New Order Webhook is triggered when an order is created. This means the order has been validated and the payment has cleared, and now the site owner can accept or cancel the order.

This replaces the Order Created webhook, which has been deprecated and will be removed on September 30, 2022.

(April 18, 2022)

New Fields: Wix Groups API

The Wix Groups API has renamed some fields, resulting in deprecating some existing fields. The deprecated fields will be removed on June 30, 2022. In addition, the memberIds parameter in Approve Join Group Requests will be required after June 30, 2022.

For more information, see End-of-Life Notices.
(March 23, 2022)

New Release: Inbox API

The new Inbox API introduces functionality for managing conversations and messages between the site and its visitors, contacts, and members.

This deprecates the Wix Chat API. (March 1, 2022)

New Release: Account Level APIs

The Account Level APIs are accessible only using API keys, which are currently available to selected beta users only. APIs exposed include Sites, Site Folders, Resellers, B2B Site Management, Domain Search and Domain Connections. (February 24, 2022)

New Release: Editor Deep Link API

The Editor Deep Link API generates a URL for an app that navigates to a user's Editor and places the app's components on a page. (January 30, 2022)

New Webhooks and Endpoints: Contacts API

The new Contact Merged Webhook is triggered when source contacts are merged to a target contact. The new originatedFrom property is sent as merge when Contact Updated Webhook or Contact Deleted Webhook are triggered as the result of merging, allowing you to ignore redundant events.

The Query Labels and Query Extended Fields endpoints are also now available.

(January 25, 2022)

New Release: Wix Members Badges API

The Wix Members Badges API provides third parties with the ability to read existing site members’ badges used on Wix apps, and create and assign badges to site members from their own apps. (December 14, 2021)

New Release: Wix Forums API

The Wix Forums API provides third parties with the ability to read a site’s Wix Forums and members’ posts, and receive updates on new Wix Forum activities via webhooks from their own apps. (December 14, 2021)

New Release: Wix Members Activity Counters API

The Wix Members Activity Counters API provides third parties with the ability to read public counts of member activities from Wix apps, and read and set public and private counts of member activities from their own apps. (November 24, 2021)

New Release: Wix Blog Post Stats API

The Wix Blog Post Stats API provides the ability to get the total number of posts published to a blog, and to filter for number of posts published per month. (October 28, 2021)

New Release: Wix Restaurants Orders API

The Wix Restaurants Orders API provides the ability to retrieve orders and update their statuses. (October 26, 2021)

New Release: Marketing Tags API

The Marketing Tags API provides the ability to manage embedded marketing tags. (October 26, 2021)

New Release: Query Service Catalog

The Query Service Catalog endpoint replaces List services, which has been deprecated. (October 13, 2021)

New Webhooks: Contacts v4

The Contacts v4 API introduces the Contact Created, Contact Updated, and Contact Deleted webhooks.
This deprecates the Contacts v1 webhooks. (September 13, 2021)

New Release: Query Bookings Resources

The Query Resources endpoint replaces List Resources, which has been deprecated. (September 13, 2021)

New Data: Bookings Resources

location.businessLocation field added to Resource object.
Note that the location.businessLocation.businessSchedule object is not supported by Wix Bookings. (September 13, 2021)

New Release: FAQ API

The FAQ API provides the ability to view and manage the questions and answers in the FAQ app. (August 24, 2021)

New Data: App Instance API

ownerEmail field added to Get App Instance endpoint response. (August 8, 2021)

New Data: Stores Orders API

order.shippingInfo.code field added to Wix Stores Orders object.
The code field can be used by carrier services / fulfillers to see orders shipped by them. (July 25, 2021)