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.

HTTP status	Error code	Error message	Troubleshooting
`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 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 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.