Teammates allows multiple users, or Teammates, to send emails from a single SendGrid account. It enables groups of users with different roles and responsibilities to share one account, where each of these users has access to varying SendGrid features depending on their needs. By only giving your individual team members access to the features that they need to do their jobs, you can limit access to sensitive areas of your account. Teammates makes it easy to add, remove, and manage different users.
Free and Essentials plans allow for adding one Teammate per account and do not offer Single Sign-On (SSO), while Pro and higher plans allow for up to 1000 Teammates and include SSO and other features. Learn more about the different Email API Plans.
As an account owner or administrator, you can add a Teammate to your SendGrid account. Depending on your Email API Plan, you have the option to add a password or an SSO Teammate. A password Teammate logs in with a username, password, and Twilio SendGrid 2FA (when configured), while the latter logs in via SSO.
You can add one password Teammate to your account on the SendGrid UI:
You can add up to 1,000 Teammates to your account. On these plans, you have the option to add a Teammate via password or SSO authentication:
Before adding an SSO Teammate, enable Single Sign-On for your SendGrid account. To add a Teammate:
Teammate invitations are valid for 7 days. Before the expiration, you can resend or delete the invitation.
While only account owners and administrators can create Teammates, it is possible for one administrator to create another Teammate with administrator permissions. This new Teammate will then be able to create and manage other Teammates and have access to the account's billing settings. Please be very careful about assigning administrator permissions.
Only administrator Teammates may impersonate subusers.
After a SendGrid account administrator adds you as a Teammate, your onboarding flow is determined by the type of Teammate invitation.
If you are added as a password Teammate, SendGrid sends you a welcome email with a link to set up your profile.
Please consult with your SSO administrator for logging in as an SSO Teammate and understanding your SendGrid account permissions.
The three different permission levels are:
If you select Invite with Restricted Access when inviting a Teammate, you need to select a preset access level or create your own by selecting Custom Access. You can choose from several pre-defined permission levels to fit a variety of roles: Developer Access, Marketer Access, and Accountant Access or you can customize access for the Teammate.
To modify an existing Teammate's permissions:
To delete a Teammate:
You cannot recover deleted Teammates. Once a Teammate has been deleted, it can never be restored. SendGrid will not remove any templates, campaigns, contacts, or API keys created by the Teammate.
If you are already signed into a SendGrid account as a Teammate, but do not have access to a page or feature, you may request access to that page by clicking Request Access.
Once a request is made, all account administrators receive a notification in the Teammates page (Settings > Teammates) that a request is pending approval.
You can find any access requests listed under Pending Requests on the Teammates page in your Settings. The request will list the username of the Teammate, their email address, their first and last names, along with the feature that they requested access to.
To grant that Teammate access to the feature, click Approve.
By clicking "Approve" you are giving that Teammate full access to the feature! If you only want to give them limited access to the feature, you must navigate back to their Teammate settings to make adjustments to their granular permissions.
If you do not want to grant them access, click Deny.
For a complete list of permissions or scopes available to a Teammate, see Teammate Permissions.
The Teammate receives a notification email when they are either granted or denied access. SendGrid delivers these emails, but the "reply to" address is the email address on file for the account owner.
API Keys are used to authenticate API calls. Just as a Teammate can be given specific permissions, API keys can be assigned specific permissions to restrict which API calls they can authenticate.
You can use API Keys and Teammates as different methods of restricting access to the same SendGrid features.
However, a Teammate cannot change their own permissions via API key. For example, a Teammate with restricted access to features in the SendGrid user interface but full access to API Keys cannot make an API call to modify their permissions in the UI.