> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Sample Flows

## Article: Sample Flows

## Article Link: https://dev.wix.com/docs/api-reference/account-level/domains/connected-domains/sample-flows.md

## Article Content:

# Sample Use Cases & Flows: Connected Domains

This article shares a possible use case your app could support, as well as an example flow.
You're certainly not limited to this use case, but it can be a helpful jumping off point
as you plan your app's implementation.

## Connect an external domain using name servers

You could help site owners connect an external domain using name servers
to their Wix site.

To connect an external domain using name servers to a Wix site:

1. If the relevant site is a free Wix site, call
   [Resellers Create Package v2](https://dev.wix.com/docs/rest/account-level/resellers/packages-and-product-instances/create-package-v2.md)
   to assign a Premium plan to it. Contact the
   [Wix B2B sales team](mailto:bizdev@wix.com) for details about supported
   product IDs.
1. Register the domain through an external provider.
1. Call [Create Connected Domain](https://dev.wix.com/docs/api-reference/account-level/domains/connected-domains/connected-domain-v1/create-connected-domain.md)
   to start the connection process. Make sure to use
   `{"connectionType": "NAMESERVERS"}`.
1. Call [Get Connected Domain Setup Info](https://dev.wix.com/docs/api-reference/account-level/domains/connected-domains/connected-domain-setup-info-v1/get-connected-domain-setup-info.md)
   to retrieve the new DNS record values. You find them in
   `connectedDomainSetupInfo.pointingRecords.aRecord.values`
   and `connectedDomainSetupInfo.pointingRecords.cnameRecord.value`.
1. Call [Update Dns Zone](https://dev.wix.com/docs/rest/account-level/domains/domain-dns/update-dns-zone.md)
   to change the A and CNAME records in Google's Cloud DNS.
1. Call [Get Connected Domain](https://dev.wix.com/docs/api-reference/account-level/domains/connected-domains/connected-domain-v1/get-connected-domain.md)
    to monitor the connected domain's `dnsPropagationStatus` and confirm that it changes to `"COMPLETED"`.

## Connect an external domain by pointing

You could help site owners connect an external domain by pointing
to their Wix site.

To connect an external domain by pointing to a Wix site:

1. Call [Create Package](https://dev.wix.com/docs/rest/account-level/resellers/packages-and-product-instances/create-package-v2.md)
    from the Resellers API to assign a Wix Premium plan to the Wix site. Contact the
    [Wix B2B sales team](mailto:bizdev@wix.com) for details about supported product IDs.
1. Call [Create Connected Domain](https://dev.wix.com/docs/api-reference/account-level/domains/connected-domains/connected-domain-v1/create-connected-domain.md).
1. Call [Get Connected Domain Setup Info](https://dev.wix.com/docs/api-reference/account-level/domains/connected-domains/connected-domain-setup-info-v1/get-connected-domain-setup-info.md)
    to retrieve the new DNS record values. You find them in
    `connectedDomainSetupInfo.pointingRecords.aRecord.values` and
    `connectedDomainSetupInfo.pointingRecords.cnameRecord.value`.
1. Assist the site owners with setting up the new A and CNAME records. This can't be
    done using Wix APIs, you must use the infrastructure of the external domain
    registrar.
1. Call [Get Connected Domain](https://dev.wix.com/docs/api-reference/account-level/domains/connected-domains/connected-domain-v1/get-connected-domain.md)
    to monitor the connected domain's `dnsPropagationStatus` and confirm that it changes to `"COMPLETED"`.

## Connect a subdomain

You could help site owners connect a subdomain
to their Wix site.

To connect a subdomain to a Wix site:

1. Call [Create Package](https://dev.wix.com/docs/rest/account-level/resellers/packages-and-product-instances/create-package-v2.md)
    of the Resellers API to assign a Wix Premium plan to the Wix site. Contact the
    [Wix B2B sales team](mailto:bizdev@wix.com) for details about supported product IDs.
1. Call [Create Connected Domain](https://dev.wix.com/docs/api-reference/account-level/domains/connected-domains/connected-domain-v1/create-connected-domain.md).
1. Call [Get Connected Domain Setup Info](https://dev.wix.com/docs/api-reference/account-level/domains/connected-domains/connected-domain-setup-info-v1/get-connected-domain-setup-info.md)
    to retrieve the new DNS record values. You find them in
    `connectedDomainSetupInfo.subdomainRecords.cnameRecords.value`.
1. Assist the site owners with setting up the new CNAME records. This can't be
    done using Wix APIs, you must use the infrastructure of the external
    domain registrar.
1. Call [Get Connected Domain](https://dev.wix.com/docs/api-reference/account-level/domains/connected-domains/connected-domain-v1/get-connected-domain.md)
    to monitor the connected domain's `dnsPropagationStatus` and confirm that it changes to `"COMPLETED"`.