This article outlines error messages that might be issued when calling endpoints of the Connected Domains API.
The Create Connected Domain endpoint might issue the following error messages:
HTTP status | Error code | Error message | Troubleshooting |
|---|---|---|---|
INVALID_ARGUMENT (400) | Invalid domain | Unable to connect domain <domainName>, it's available for purchase. | You must purchase the domain before you can connect it to a Wix site. |
INVALID_ARGUMENT (400) | Invalid domain | Domain <domainName> is Wix restricted. | Not all TLDs are supported for Wix sites. Contact the Wix B2B sales team for a list of supported TLDs and then try connecting a domain that's supported. |
INVALID_ARGUMENT (400) | Invalid connection type | Invalid connection type <connectionType>. | Choose a connection type that's supported for the domain. To connect a root domain, you can only connect via POINTING or NAMESERVERS. For subdomains, you aren't allowed to pass any connection type. |
INVALID_ARGUMENT (400) | DOMAINS_GUID_NOT_VALID | Wix site id and/or Wix account ID is invalid. | Check that the site and account ID are correct. |
ALREADY_EXISTS (409) | DOMAINS_ALREADY_EXISTS | Domain <domainName> with different settings is already connected. | Make sure to connect the domain only once to the relevant account or site. |
ALREADY_EXISTS (409) | DOMAINS_ALREADY_EXISTS | Domain <domainName> with different connection type is already connected. | Make sure to connect the domain only with the relevant connection type to the account or site. |
PERMISSION_DENIED (403) | DOMAINS_PERMISSION_DENIED | Permission denied for account ID <accountId>. | Check that the account ID is correct and that you have permissions to access it. |
PERMISSION_DENIED (403) | DOMAINS_DOMAIN_NOT_PERMITTED | Domain <domain> isn't permitted for the account. | Make sure that you have permissions to access the account. |
PERMISSION_DENIED (403) | INVALID_DOMAINS_PREVIEW_RECORDS | Missing A, and/or CName, and/or NS preview records for domain <domainName>. | Make sure to pass the relevant DNS records. |
PERMISSION_DENIED (403) | DOMAINS_GUID_NOT_FOUND | - | Make sure to pass a valid account ID. |
PERMISSION_DENIED (403) | NON_PREMIUM_SITE | Domain <domain> can't be assigned to free Wix site <siteId>. | Make sure to assign a Premium Plan to the site before connecting the domain. |
The Get Connected Domain endpoint might issue the following error messages:
HTTP status | Error code | Error message | Troubleshooting |
|---|---|---|---|
INVALID_ARGUMENT (400) | DOMAINS_GUID_NOT_VALID | Wix site and/or account ID are invalid. | Check that the site and account ID are correct. |
NOT_FOUND (404) | NOT_FOUND | Domain name <domainName> wasn't found. | Make sure to pass the correct domain name. |
PERMISSION_DENIED (403) | DOMAINS_PERMISSION_DENIED | Permission denied for account ID <accountId>. | Check that the account ID is correct and that you have permissions to access it. |
PERMISSION_DENIED (403) | DOMAINS_DOMAIN_NOT_PERMITTED | Domain <domain> isn't permitted for the account. | Make sure that you have permissions to access the account. |
PERMISSION_DENIED (403) | DOMAINS_GUID_NOT_FOUND | - | Make sure to pass a valid account ID. |
The Get Connected Domain Setup Info endpoint might issue the following error messages:
HTTP status | Error code | Error message | Troubleshooting |
|---|---|---|---|
INVALID_ARGUMENT (400) | DOMAINS_GUID_NOT_VALID | Wix site and/or account ID are invalid. | Check that the site and account ID are correct. |
PERMISSION_DENIED (403) | DOMAINS_PERMISSION_DENIED | Permission denied for account ID <accountId>. | Check that the account ID is correct and that you have permissions to access it. |
PERMISSION_DENIED (403) | DOMAINS_DOMAIN_NOT_PERMITTED | Domain <domain> isn't permitted for the account. | Make sure that you have permissions to access the account. |
PERMISSION_DENIED (403) | DOMAINS_GUID_NOT_FOUND | - | Make sure to pass a valid account ID. |