Custom Domain Kit
Docs/Integration

Create an App

Create an App

An application represents one SaaS product or environment. Create separate applications for production, staging, and local fixtures when they use different origins or secrets.

Dashboard Steps

  1. Open Applications.
  2. Create a new application.
  3. Enter a product or environment name.
  4. Set the origin URL that customer-domain traffic should reach.
  5. Choose the connection mode.
  6. Save the app secret immediately.
  7. Add the webhook endpoint you will use for domain status updates.

Origin URL

The origin URL should be the stable HTTPS URL for your product.

Valid examples:

https://app.example.com
https://tenant-router.example.com

Avoid origin URLs with credentials, query strings, fragments, localhost, or private development hostnames.

App Secret

The app secret starts with cdk_sk_ and is shown once.

Store it only in server-side secret storage. Your browser bundle, mobile app, logs, analytics, and support exports must not contain the app secret.

Webhook Endpoint

Add an HTTPS webhook URL, for example:

https://app.example.com/webhooks/custom-domain-kit

The webhook signing secret is also shown once. Store it separately from the app secret.