The Connected Domains API allows you to connect domains that haven't been registered through Wix to a Wix site. You can connect domains either by nameservers or pointing. The domain can be assigned as the primary domain or a redirect. It may take up to 48 hours for the DNS changes to take effect when creating a connected domain.
With the Connected Domains API you can:
- Create and retrieve connected domains
- Retrieve setup information
Read more about . You can use the to manage DNS zones for domains that are connected by nameservers. If you plan to register available domains through Wix you can use the .
It’s important to note the following points before starting to code:
- The Connected Domains API is accessible via API keys. You can't access this API with a standard Auth header. We recommend authenticating calls with an API key for your main account instead of using a key for the relevant sub-account. But the responses to calls remain consistent across API keys, provided you have the necessary permissions.
- Once you create a connected domain, it may take up to 48 hours for the DNS changes to take effect. Learn more about .
- You can only connect domains to a Wix site with an active . Use the to add Premium plans and other paid Wix services to your customers' sites.
- Wix doesn't manage DNS records for domains that are connected by pointing. That means you can use the to update DNS zones only for domains that are connected by nameservers.
- You can't connect to Wix sites with the Connected Domains API.
- Connected domain: A domain that's owned by an external provider, not Wix. Also called external domain.
- Registered domain: A domain that's owned by Wix and billed through Wix.
- Connection type: Information about how the domain is connected to the Wix
- Nameserver: A server component of the DNS that stores human-readable domain names. With this connection type, Wix hosts your DNS, while your domain remains registered with its current host.
- Pointing: A connection type for cases where the DNS is hosted outside of Wix. Read more about .
- Setup information: Information that helps site owners navigate the connection process. Includes the name of the domain's external registrar and information about DNS records.
- Reseller: Strategic partner that offers Wix services to their customers. Read more about .
- Account: Wix account that includes access to associated sites.
- Team account: Account type that supports collaborative work by having multiple sets of login credentials. This is especially helpful for agencies and resellers when managing a large number of customer sites. In Wix Studio team accounts are called workspaces. An agency may have multiple workspaces in Wix Studio, while in Wix Editor they're limited to a single team account.
- Sub-account: Account that's contained within another account, forming a hierarchical structure. The owners of the sub-account are only able to interact with sites that belong to the sub-account. This setup is particularly useful for agencies and resellers since it limits client access to relevant sites only.