This articles outlines error messages that might be issued when calling endpoints of the Registered Domains API.
The Create Registered Domain endpoint might issue the following error messages:
HTTP status | Error code | Error message | Troubleshooting |
---|---|---|---|
INVALID_ARGUMENT (400) | INVALID_DOMAIN | Domain <domainName> can't be registered. | Check that the TLD is supported by Wix and that the domain is still available for purchase. |
INVALID_ARGUMENT (400) | DOMAIN_TOO_LONG | Domain <domainName> can't be registered because the domain name is too long. | Make sure that the domain name (excluding TLD) isn't longer than 63 characters. |
INVALID_ARGUMENT (400) | DOMAIN_TOO_SHORT | Domain <domainName> can't be registered because the domain name is too short. | Make sure that the domain name (excluding TLD) includes at least 3 characters. |
INVALID_ARGUMENT (400) | INVALID_TLD | Product instance <productInstanceId> includes the benefit to register a domain with TLD <TLD> . You can't register a domain with another TLD using this product instance. | Check that the <productInstanceID> and the TLD are correct. Call Adjust Product Instance Specifications to provide the missing benefit. Contact the Wix B2B sales team for details about the relevant productID . |
INVALID_ARGUMENT (400) | TLD_NOT_SUPPORTED | Domain <domainName> can't be registered because the TLD <tld> isn't supported for Wix sites. | Contact the Wix B2B sales team to check which TLDs are supported. |
PERMISSION_DENIED (403) | PERMISSION_DENIED | Permission denied for target account <targetAccountId> . | Make sure that the account ID is correct and that you have permissions to access the account. |
INVALID_ARGUMENT (400) | CANNOT_ASSIGN_DOMAIN_TO_FREE_SITE | Domains can't be assigned to free Wix sites. | Make sure that the site you want to assign the domain to has an active Premium plan. You can use Create Package to assign a Premium plan to your customer's site. Contact the Wix B2B sales team for information about the relevant productID . |
INVALID_ARGUMENT (400) | PRODUCT_INSTANCE_NOT_FOUND | Subscription for product instance <productInstanceId> doesn't exist. | Check that the productInstanceId is correct. You can only register a domain to a Wix account that owns a reseller product instance for a domain with the specified TLD. |
INVALID_ARGUMENT (400) | INVALID_PRODUCT_INSTANCE | Product instance <productInstanceId> doesn't include the benefit to register a domain. | Check that the productInstanceId is correct. You can call Adjust Product Instance Specifications to provide the missing benefit. Contact the Wix B2B sales team for details about the relevant productID . |
INVALID_ARGUMENT (400) | PRODUCT_INSTANCE_NOT_ACTIVE | Product instance <productInstanceId> has status <status> . You can only register a domain if the related product instance is "ACTIVE" . | You can only register a domain if the relevant Wix account or site has an active subscription for a Premium plan that supports domains of the specified TLD. Check that the status of the relevant product instance is "ACTIVE" . To check, call Get Package. |
INVALID_ARGUMENT (400) | AWAITING_PRODUCT_ACTIVATION | Product instance <productInstanceId> is "ACTIVE" , but you still need to wait before you can register a domain using it. | Try calling Create Registered Domain again in a couple of minutes. Contact the Wix B2B sales team if the error persists. |
INVALID_ARGUMENT (400) | REGISTERED_DOMAIN_ALREADY_EXISTS | Domain <domainName> has already a related registeredDomain object. | You can't call Create Registered Domain for a domain that's already registered or in the process of being registered. If the registration status is "FAILED_REGISTRATION" , you can call the endpoint again. |
INVALID_ARGUMENT (400) | DOMAIN_ALREADY_TAKEN | Domain <domainName> has already been purchased. | You can only register domains that are still available for purchsase. You may call Check Domain Availability or Suggest Domains to identify available domains. |
INVALID_ARGUMENT (400) | INVALID_BILLING_CYCLE | Product instance <productInstanceId> from subscription <subscriptionId> has a billing cycle that doesn't support registering the domain. | Check that <productInstanceID> and the billing cycle are correct. You can use the Resellers API in case you need to create or modfiy a subscription. |
INVALID_ARGUMENT (400) | SUBDOMAIN_NOT_SUPPORTED | You can't register subdomains. | Make sure to register only root domains. |
INVALID_ARGUMENT (400) | SKU_NOT_FOUND | Wix hasn't defined product instance <productInstanceId> properly. | Contact the Wix B2B sales team for help. |
The Get Registered Domain endpoint might issue the following error messages:
HTTP status | Error code | Error message | Troubleshooting |
---|---|---|---|
INVALID_ARGUMENT (400) | REGISTERED_DOMAIN_NOT_FOUND | Registered domain <registeredDomainId> doesn't exist. | Make sure that the ID of the registered domain is correct. |