Using custom domains

Custom documentation domains are available on Postman Team, Business, and Enterprise plans.

You can use a custom domain for your API documentation.

Adding a custom domain

In the Postman web dashboard, select Team Settings from the Team tab.

In the Custom Domains section, you will see a list of domains indicated with verification status. Click + Add a new domain.

In the Add a Custom Domain page, enter the URL of the domain you want to add. Your custom domain can be a full domain or a subdomain. For example, you can use either example.com or api.example.com.

Click Proceed to verify the domain.

Verifying your domain

When you add a custom domain, you will see a modal displaying the DNS records required to verify domain ownership. To verify that you control the domain you're attempting to add, you must add these provided tokens as DNS records to your domain for TXT and CNAME.

Adding DNS records

For DNS records, verify the ownership with a DNS web service provider. In a separate browser tab, go to the DNS provider’s console and add the following two new records.

1. A TXT record for postman-echo.com verifies the ownership of the domain. The value should be the same as the token shown in the modal. Add the TXT record to the root domain. For example if you're adding example.com or api.example.com, add the TXT record to example.com.
2. A CNAME record for docs.postman-echo.com, as shown in the modal—this should be phs.getpostman.com. Add the CNAME record to the URL that's associated with your public documentation.

To verify the domain, check the I've added the TXT and CNAME records checkbox, then click Verify Domain. A confirmation message should indicate that the domain has been verified.

Postman uses LetsEncrypt as an SSL certificate provider to enable hosting public documentation on your domain. LetsEncrypt generates a certificate implicitly if your domain has no CAA records. If your domain has CAA records set, then LetsEncrypt needs an explicit CAA record to issue a certificate for that domain. To enable LetsEncrypt issue this certificate, refer to the LetsEncrypt Documentation.

If you don't want to verify the domain now, click Verify Later.

You can remove the custom domain by clicking Delete Custom Domain.

Occasionally, your DNS settings may not take effect immediately. If so, an error message may appear—please try again later.

Publishing a collection on your custom domain

When your domain is verified, you can use it to publish your API documentation. If you have a collection already published, you can edit it to use the new domain.

Next steps

You can make your documentation more discoverable by adding it to the API Network or Postman Templates.