Go Headless

Build Apps

Client

API Preview

Develop Websites

REST

Velo

GraphQL (Alpha)

# 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](https://dev.wix.com/api/rest/account-level-apis/resellers/introduction) 
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](mailto:bizdev@wix.com) 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](https://support.wix.com/en/article/choosing-a-premium-plan) 
  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](mailto:bizdev@wix.com) 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](https://dev.wix.com/api/rest/account-level-apis/resellers/introduction) 
  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](https://dev.wix.com/api/rest/account-level-apis/b2b-site-management/transfer-site) 
  call. It must be specified in the header.
  


# 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](https://dev.wix.com/api/rest/account-level-apis/b2b-site-management/transfer-site) endpoint might issue the following error messages:

| <div style="width:200px">HTTP status</div> | <div style="width:250px">Error code</div> | <div style="width:280px">Error message </div> | <div style="width:300px">Troubleshooting </div> |
| --------------------------- | ----------------------------------- | ------------------------------------------------------------ | ------------------------------ |
| `FAILED_PRECONDITION (428)` | `TARGET_ACCOUNT_ID_NOT_FOUND` | Target account wasn't found. | Check that the target account ID exists. |
| `PERMISSION_DENIED (403)` | `SITE_TRANSFER_NOT_ALLOWED` | Site transfer isn't allowed for `sourceAccountId` and `targetAccountId`.  | Contact the [Wix B2B Sales team](mailto:bizdev@wix.com) to check that the specified target and source accounts are supported for site transfers. |
| `INVALID_ARGUMENT (400)` | `SITE_NOT_FOUND` | `siteId` wasn't found in `accountId`. | Check that the site exists and that it belongs to the source account. |
| `FAILED_PRECONDITION (428)` | `SITE_TRANSFER_NOT_SUPPORTED` | Site 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](https://dev.wix.com/api/rest/account-level-apis/resellers/packages/cancel-package) 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](https://dev.wix.com/api/rest/account-level-apis/resellers/packages/create-package-v2) to add the paid Wix service to the site again. |

The B2B Site Transfer object contains information about a site transfer.

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`.

enableNotifications

ID of the site. See the
[Sites API](https://dev.wix.com/api/rest/account-level-apis/sites/query-sites)
for more details.

siteId

ID of the source account.
Contact the [Wix B2B sales team](mailto:bizdev@wix.com) for more
information about supported source accounts.

sourceAccountId

SiteTransfer

TransferSiteRequest

TransferSiteResponse

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](mailto:bizdev@wix.com) 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](mailto:bizdev@wix.com) 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](https://dev.wix.com/api/rest/account-level-apis/resellers/introduction)
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.

Business Site Transfer Object