Skip to main content

​
Custom domains

Organizations can configure a custom domain so students take oral assessments and roleplay on your hostname with your logo, company name, and post-exam redirect URL.
Custom domains serve exam-taking pages only — not the full Coraltalk platform. Admin, billing, API keys, VidTickets, and other routes return 404 on your custom domain.

​
Allowed routes on custom domains

​
Setup (organization admin UI)

  1. Sign in at app.coraltalk.com as an org admin.
  2. Open Custom domains in organization settings.
  3. Enter your hostname (e.g. exams.yourschool.edu).
  4. Add the CNAME record shown at your DNS provider.
  5. Click Verify and wait for DNS propagation.
  6. Configure white-label: company name, logo, post-exam redirect URL.
  7. Choose Applies to: oral assessments, roleplay, or both.

​
DNS example

TLS is provisioned automatically after verification.

​
Student sign-in (custom domains)

Clerk satellite mode on your domain blocks normal email-code and OAuth sign-in. Your backend must call the Platform API (not the exam hostname): Return data.token to the exam page; the client signs in with Clerk strategy: "ticket". See Student sign-in token and Authentication.
Do not call a separate /api/student/sign-in-token route on the custom domain. All Platform API requests use https://app.coraltalk.com/api/v1/{env}/.