Domains
To invite your employees to the organization with their company email addresses, associate your organization with one or more internet domains that you own. Domain association also lets you treat ownership of one of your company email addresses as a sign of trust.
Before you can add a domain with your organization, you must verify that you own it. Twilio Console's Domains page lists both any added domains and those undergoing verification. By default, Twilio limits each organization to 100 domains. To increase this limit, contact support.
To associate your organization with a specific domain:
Verification requires domain ownership
Common domains like Gmail or Hotmail can't be verified in Twilio's organizations. You can't invite users to an organization with an unverified domain.
- Log in to Twilio Console and navigate to the Domains page.
- Click Add Domain.
- On the Add Domain page, enter your company's domain name.
- On the Choose verification method page, select a verification method: DNS, HTTPS, I am not sure which option to use.
DNS
The Verify your domain using the DNS method section appears with a twilio-domain-verification= followed by 32-hexadecimal digits.
-
Copy the
twilio-domain-verification=value. -
Go to your DNS provider.
-
Following your DNS provider instructions, create a DNS record with the following values:
Parameter Value Type TXTName _twilioValue twilio-domain-verification=<32-hexadecimal-characters>TTL 3600 -
Click Check verification.
After you click the button, Twilio checks your DNS record. DNS propagation can take up to 72 hours. Twilio might not mark your domain as verified straight away.
HTTPS
The Verify your domain using the HTML method section appears.
- Click Download HTML file. The verification file downloads to your computer.
- Upload the verification file to the root public directory of your website.
To check for the file after uploading, click the link displayed on the Verify Domain page. - Click Check verification.
After you click the button, Twilio checks your uploaded file.
I am not sure which option to use
The Verify your domain through your IT Team section appears.
- Copy the email message displayed.
- Paste the email message into your email client.
- Send the message to your IT team. The message notes that you can provide an HTML file.
If your IT team requests that file, follow the directions in the HTTPS tab. - Click Check verification.
To confirm your continued ownership, Twilio re-checks the file upload or DNS data every 24 hours.
- If the token gets altered or removed, an organization's Owner or Administrator has 30 days to re-validate the domain before Twilio deletes it from the organization.
- Until Twilio re-validates the domain, you can't add users that use email addresses from that domain.
- If your domain remains unvalidated for more than 30 days, Twilio removes any managed users added to the organization. After validating the domain, add the managed users back to the organization.
To remove a domain from your organization:
- Log in to Twilio Console and navigate to the Domains page.
- Click
⋮(action menu) and click Delete for the domain you want to delete. - Check all acknowledgment boxes and click Delete.
In some situations, organizations might keep different business units as separate Twilio organizations. To enable these units to access organization-level functionalities, Twilio allows more than one Twilio organization to verify the same internet domain. Twilio calls a domain a multi-verified domain.
Organizations with a multi-verified domain can:
- Verify the same domain in more than one organization. Up to 20 organizations can use the same domain.
- Manage users and respective accounts in each Twilio organization without dependencies from other organizations with the same domain.
- Enforce single sign-on for their specific set of users.
Organizations with multi-verified domain can't:
- Apply the organization settings with get users to auto-join or join through invitation only settings.
- Bulk import users without invitation.
Only one organization at a time can manage a user or account.
When one organization verifies the previously verified domain, Twilio notifies all organizations and disables the previous functionalities. If you want to verify your company's internet domain in more than one organization, contact support.
To learn how to bulk import existing Twilio users from your verified domain into your organization, see Import Users.