Skip to main content

Overview

By default, all verified domains are available to every project within your team. Project limits allow you to restrict a domain so that only specific projects can send emails from it.
This feature is useful when you have multiple projects with different purposes and want to ensure that sensitive or brand-specific domains are only used by authorized projects.

How It Works

Domains can be in one of two states:
StateDescription
UnrestrictedDomain can be used by any project in your team (default)
RestrictedDomain can only be used by explicitly selected projects
When a project attempts to send an email using a restricted domain it doesn’t have access to, the API will return an error:
The domain 'mail.acme.com' is not available for use by this project.

Configuring Project Limits

You can configure which projects have access to a domain from the domain settings page.
Domain project limits configuration

Restricting a Domain

  1. Navigate to Domains in your dashboard
  2. Click on the domain you want to restrict
  3. In the project limits section, select the projects that should have access
  4. Save your changes

Removing Restrictions

To make a domain available to all projects again, simply remove all project selections. An empty selection means the domain is unrestricted and available to all projects in your team.

Access Control

When a domain is restricted to specific projects, it affects who can manage the domain:
RoleCan Edit Restricted Domain?
Team OwnerAlways
Team MemberOnly if they have access to at least one of the restricted projects
Team members who don’t have access to any of the restricted projects will see the domain as read-only and cannot modify its settings.

API Reference

You can also manage project limits programmatically using the Team API. See the Update Domain Projects endpoint for details.