Skip to main content

Custom Domains

Feature Availability

The custom domains feature is available to customers on specific pricing plans. Refer to your pricing plan or contract, or contact the Prismatic support team to learn more.

You can choose to interact with the Prismatic platform through a custom domain that you control. For example, you might want to white-label Prismatic so your team members and customers access https://integrations.your-company.com instead of https://app.prismatic.io.

To configure a custom domain, please reach out to our support team, and let us know what subdomain (like https://integrations.your-company.com) you would like to use. We'll create an SOA record for that subdomain along with a few A and CNAME records for things like web app access, webhook invocation, and OAuth 2.0 callbacks:

  • https://integrations.your-company.com - web app and embedded URL
  • https://hooks.integrations.your-company.com - webhooks
  • https://**oauth2.integrations**.your-company.com - OAuth 2.0 callback

Once we have those records ready, you'll just need to create an NS record to point to a list of nameservers we'll provide you. Note: some DNS providers represent a list of NS servers as separate NS records (one server per record), and others have single NS records with a list of values.

Once your domain is white-labeled, your OAuth2 apps can use https://oauth2.integrations.your-company.com/callback as a callback URL.

Webhook and OAuth 2.0 URLs are derived from the URL you visit

Note that once a subdomain is configured, you can access your tenant through either the custom domain or the default Prismatic domain. Custom domains are not tenant-specific. If you have prod and dev tenants, both tenants can use the custom domain you establish.

  • If you access or embed Prismatic via https://app.prismatic.io, you will see webhook and OAuth URLs with the Prismatic domain.
  • If you access or embed Prismatic via your custom domain like https://integrations.your-company.com, you will see webhook and OAuth URLs with your custom domain.