Domains
Hyvor Relay requires that all emails are authenticated using DKIM. Therefore, you need to first configure the domains of the email addresses you want to send emails from (FROM address). This is a one-time setup for each domain in a project. Once you configure a domain, you can send emails from any email address under that domain without any additional configuration.
To verify your domain, you need to add a TXT record to your domain's DNS settings. Hyvor Relay uses this TXT record to verify that you own the domain. Email providers use this TXT record for DKIM verification.
Configuring Domains in the Console
You can add domains in the Hyvor Relay Console:
Then, you will see the instructions to add a TXT record to your domain's DNS settings.
Once you add the TXT record, click the Verify button. It might take a few minutes for the verification to complete. Once verified, you can start sending emails from this domain.
Make sure to keep the TXT record in your domain's DNS settings.
Domain Status
A domain can be in one of the following states:
- Pending: The domain is pending verification. You cannot send emails from this domain until it is verified. You have 14 days to verify the domain, or it will be automatically removed.
- Verified: The domain is verified, and you can send emails from this domain.
- Warning: The domain is put on warning status. This can happen if the TXT record is removed or changed. You can still send emails from this domain, but you must resolve the issue within 24 hours, or the domain will be marked as unverified.
- Suspended: The domain is banned from sending emails. This can happen if the domain is flagged for spam, abuse, or other issues. You cannot send emails from this domain until the issue is resolved. Contact support to resolve the issue. If not resolved within 14 days, the domain will be automatically removed.
Automating Domains using the API
Manually configuring domains might not be feasible if you have a large number of domains or if you allow your users to send emails using their own domains. In such cases, use the Console API to automate domain configuration. See Domains in Console API to get started.
Note that the verification process is asynchronous. You need to poll the GET /domains/:id or GET /domains/:domain endpoint periodically to check the status of the domain
verification. Or, you can use the domain.verified webhook to get notified when the domain is verified.
FAQs
What DNS records should I add?
Only one: a DKIM TXT record. The exact value of the TXT record is provided in the Hyvor Relay Console
when you add a domain. The hostname is unique for the project and is in the format rly20250709021031291c6964._domainkey.example.com
How long does it take to verify a domain?
After adding the TXT record to your domain's DNS settings, it will take a few minutes in most cases.
In some cases, it may take up to 24 hours for the DNS changes to propagate. You can check the status
of the domain in the Hyvor Relay Console or using the Console API. We run a verification check every
5 minutes. You will also receive an email notification when the domain is verified.
Can I use the same domain in multiple projects?
Yes, however, you need to add a separate TXT record for each project since the DKIM selector is unique
for each project.
What happens if I delete a domain?
Deleting a domain will stop all sending activity from that domain and remove all associated credentials,
DNS verification status, and sending logs. This action is irreversible.
Can I use emails of a subdomain of the configured domain?
No, currently you cannot use emails of a subdomain ([email protected]) of the configured
domain (example.com). You need to configure each subdomain separately.