About the B2B Site Management API

With the B2B Site Management API, strategic partners can transfer a Wix site from a source account to a target account. This allows their customers to have exactly the permissions they need, while the strategic partner retains access to the sites. Contact the Wix B2B sales team at bizdev@wix.com to learn how to become a strategic partner and which accounts are supported as source and target.

After transferring the site, strategic partners can use the Resellers API to offer paid Wix services to their customers.

Terminology

  • Wix account: A Wix account can have one or more users. Standard accounts have one user, while team accounts can have multiple users. Each account can hold multiple sites.
    • Sub-account: You can create sub-accounts for your customers. This allows you to access your customers’ sites while customers have the functionality and permissions they need.
    • Source account: The account holding the site before the transfer. Not all Wix accounts are supported as source accounts. Contact the Wix B2B sales team for more information.
    • Target account: The account holding the site after the transfer. The target account must be your main account or one of its sub-accounts.
  • Wix site: A website in an account. Sites are accessible to users according to the specific permissions they hold on the site or the entire account.
  • Paid Wix service: A service Wix offers site owners that isn’t free of charge. For example, a Website Plan, Business & eCommerce Plan, or Ascend. See Wix Premium Subscriptions for more details.

Limitations

  • Only strategic partners of Wix services can transfer sites. Contact the Wix B2B sales team at bizdev@wix.com to learn how to become a strategic partner and which accounts are supported as source and target.
  • You can transfer a site only to your main account or one of its sub-accounts. It isn’t possible to transfer a site to an unrelated account. Contact the Wix B2B sales team for more information.
  • Only sites that don’t include paid Wix services can be transferred. After transferring the site, you can use the Resellers API to offer paid Wix services to your customers.
  • The ID of the target account can't be passed in the body of the Transfer Site call. It must be specified in the header.
Was this helpful?
Yes
No

B2B Site Management Errors

This articles outlines error messages that might be issued when calling endpoints of the B2B Site Management API.

Transfer Site Errors

The Transfer Site endpoint might issue the following error messages:

HTTP status
Error code
Error message
Troubleshooting
FAILED_PRECONDITION (428)TARGET_ACCOUNT_ID_NOT_FOUNDTarget account wasn't found.Check that the target account ID exists.
PERMISSION_DENIED (403)SITE_TRANSFER_NOT_ALLOWEDSite transfer isn't allowed for sourceAccountId and targetAccountId.Contact the Wix B2B Sales team to check that the specified target and source accounts are supported for site transfers.
INVALID_ARGUMENT (400)SITE_NOT_FOUNDsiteId wasn't found in accountId.Check that the site exists and that it belongs to the source account.
FAILED_PRECONDITION (428)SITE_TRANSFER_NOT_SUPPORTEDSite transfer isn't supported for sites with paid Wix services.The specified site includes a paid Wix service. Use the Cancel Package endpoint of the Resellers API to remove the paid service before trying to transfer the site again. After the transfer, you can use the Create Package endpoint of the Resellers API to add the paid Wix service to the site again.
Was this helpful?
Yes
No

Business Site Transfer Object

Attributes
siteIdstringformat GUID
ID of the site. See the Sites API for more details.

sourceAccountIdstringformat GUID
ID of the source account. Contact the Wix B2B sales team for more information about supported source accounts.

enableNotificationsboolean
Whether the site owner receives an email notification from Wix about the successful site transfer. Site owners don't receive email notifications about failed transfers. Default: false.
Was this helpful?
Yes
No

PostTransfer Site

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Transfers a Wix site from the source account to the target account.

Note: You must pass the ID of the target account in the header of the call.

Only strategic partners of Wix services can transfer sites. Contact the Wix B2B sales team to learn how to become a strategic partner.

Not all Wix accounts are supported as source accounts and you can transfer a site only to your main account or one of its sub-accounts. It isn’t possible to transfer a site to an unrelated account. Contact the Wix B2B sales team for more information.

Only sites that don’t include paid Wix services can be transferred. After transferring the site, you can use the Resellers API to offer paid Wix services to your customers.

Important: This call requires an account level API key and cannot be authenticated with the standard authorization header.

Endpoint
POST
https://www.wixapis.com/b2b-site-management/v1/transfer-site

Was this helpful?
Yes
No