Organizations > Security

Verifying a Domain

Updated

Claim an email domain (like acme.com) for your organization to control who from that domain ends up joining you. Once a domain is verified, anyone signing in via SSO with an email at that domain is invited to join your organization, or can request to join it (if approval is required)

This is what you'd use to onboard a whole company at once without sending individual invites.

Before you start

  • You need to be an owner or admin of the organization.
  • You need DNS control of the domain - you'll be adding a TXT record to prove ownership. If you don't manage DNS yourself, you'll need to hand the record to whoever does.
  • Public email providers like gmail.com, outlook.com, yahoo.com, etc. are blocked. The domain has to be one you actually operate.
  • Each domain can only be claimed by one organization at a time. If someone else has already verified it, you can't claim it.

1. Open the Organization Settings page

  1. In the sidebar on the left, find the Organization section.
  2. Click Details under it. The Organization Details page opens.
CleanShot 2026-06-08 at 11.36.31@2x.png

2. Click the Domains tab

  1. Across the top of the Settings page, there's a row of tabs.
  2. Click the Domains tab.
CleanShot 2026-06-08 at 11.37.09@2x.png

If you haven't claimed any domains yet, you'll see the message No domains claimed yet.

3. Add the domain

  1. Click Add domain in the top right of the page. A dialog opens.
CleanShot 2026-06-14 at 12.10.07@2x.png
  1. In the Domain field, type the bare domain - for example mycorp.com.
  • No @ symbol in front.
  • No https:// in front.
  • No subdomains unless you specifically want a subdomain (use the apex domain in most cases).
CleanShot 2026-06-14 at 12.10.36@2x.png
  1. Decide what to do with the Require approval toggle: You can change this later, so go with whichever makes sense now.
  • Off (the default): anyone signing in with an @mycorp.com is invited, and can join your organization with no admin review.
  • On: Users with matching domains e.g @mycorp.com can request to join your organization, but an admin or owner approval will be required.

CleanShot 2026-06-14 at 12.11.20@2x.png
  1. Click Add domain at the bottom of the dialog.

CleanShot 2026-06-14 at 12.12.11@2x.png

The dialog updates to show DNS verification instructions.

CleanShot 2026-06-14 at 12.12.48@2x.png

4. Add the DNS TXT record

The dialog now shows two pieces of information you'll need to give your DNS provider:

  • Record name: the domain itself (e.g. mycorp.com).
  • TXT value: a string that looks like synteq-verify=….
  1. Click the TXT value (or the copy icon next to it) to copy it to your clipboard.
  2. Go to your DNS provider's control panel (Cloudflare, Route 53, GoDaddy, etc.).
  3. Add a new DNS record with these settings:
    1. Type: TXT
    2. Name / Host: the domain itself (or @ if your DNS panel uses @ for the apex domain)
    3. Value: the synteq-verify=… string from the dialog
    4. TTL: whatever your provider's default is. 300 seconds is fine.
  1. Save the record in your DNS provider.
  2. Back in the portal dialog, click Done to close it.

The domain now appears on the Domains tab with a Pending badge.

CleanShot 2026-06-14 at 12.13.56@2x.png

5. Verify the domain

  1. Back on the Domains tab, find the row for your new domain. It'll have a Pending badge on it.
CleanShot 2026-06-14 at 12.13.56@2x.png
  1. Click anywhere on the row to expand it.
CleanShot 2026-06-14 at 12.14.32@2x.png
  1. On the right side of the expanded row, click Verify now.
CleanShot 2026-06-14 at 12.14.54@2x.png

The portal does a DNS lookup, finds the TXT record, and confirms it matches what was generated for you.

  • On success: the Pending badge flips to Verified in green. If any users with @mycorp.com addresses already had portal accounts, a toast tells you how many of them were auto-joined (or queued for approval) by the same action.
  • On failure: you'll see TXT record not found. DNS changes can take a few minutes to propagate around the internet. Wait 2-5 minutes and click Verify now again. If it still fails after 15 minutes, double-check the record in your DNS panel - it's almost always a typo or wrong record type.

CleanShot 2026-06-14 at 22.41.14@2x.png

Switching between auto-join and require-approval

If you decide later that you want to change how new sign-ins are handled:

  1. Expand the domain row by clicking it.
CleanShot 2026-06-14 at 22.41.34@2x.png
  1. Flip the Require approval toggle inside the expanded row.
CleanShot 2026-06-14 at 22.41.53@2x.png
  1. A confirmation dialog explains the change. Slide to confirm.
CleanShot 2026-06-14 at 22.42.13@2x.png

The new setting takes effect immediately for any new sign-ins. People who already joined under the old setting are unaffected.

Removing a domain

If you no longer want to claim a domain:

  1. On the domain's row in the Domains tab, click the trash icon.
CleanShot 2026-06-14 at 22.42.36@2x.png
  1. A confirmation dialog opens asking for your password to confirm.
  1. Type your password.
CleanShot 2026-06-14 at 22.43.01@2x.png
  1. Slide the Slide to delete rail to the right.
CleanShot 2026-06-14 at 22.43.17@2x.png

The domain is removed. Anyone already in your organization keeps their access - removing the domain doesn't kick existing members out. It just stops future sign-ins from that domain auto-joining.

Verifying a Domain — Docs | Synteq