Teammates

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 incredibly easy to add, remove, and manage different users. Free and Essentials customers can create 1 teammate per account, and Pro customers or higher packages up to 1000 teammates per account.

Note: Free and Essentials customers can create 1 password teammate per account, and Pro customers or higher packages up to 1000 teammates per account. On these Pro or higher plans, you have the option to add a Teammate via password or SSO authentication. A password Teammate logs in with a username, password, and Twilio SendGrid 2FA (when configured), while the SSOs logs in via SSO. Before adding an SSO Teammate, enable Single Sign-On for your SendGrid account. Please take a look at Password and SSO Teammates for more details.

 

Adding Teammates

To invite a Teammate to your account:

  1. Navigate to Settings, and click on Teammates. On this page you can see the list of all of your current teammates with their details: username, email address, first name, and last name
  2. To add a new Teammate, click Add Teammate
  3. Enter the Teammate's email address and then select their permission level. Depending on the selected permission level, you may need to do some additional permission configuration.
  4. Click Invite. If you have already sent a teammate invitation, you will see a list titled Pending Invites. This list contains the email address of the invitee and the invitation expiration date.

    Important notes!
  • Teammate invitations are valid for 7 days
  • While only administrators can create teammates, it is possible for one administrator to create another teammate with administrator permissions. This new teammate would then be able to create and manage other teammates and have access to the account's billing settings. Please be very careful about who you assign administrator permissions
  • Only administrator teammates may impersonate subusers.

Managing Teammates | Configuring permissions

There are 3 different permission levels:

  • Restricted Access - Teammates with no access to a feature cannot change that feature’s settings or view it within the SendGrid UI. However, you can still grant them access to specific features
  • Read-only Access - Teammates with read-only access will not be able to change or configure a feature. However, they will be able to view any information provided by that feature
  • Admin - Teammates with full access that can view and make any changes.

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. Another article that goes deeper into teammate permissions can be found here.

To modify an existing teammate's permissions:

  1. Navigate to the Teammates Page under Settings
  2. Under the list of current teammates, click the action menu next to the teammate you would like to edit
  3. Click Edit to open a modal window presenting the teammate's current permissions
  4. Make your desired changes and click Update.

Removing Teammates

To delete a teammate:

  1. Navigate to the Teammates Page under Settings
  2. Click the action menu next to the teammate you want to delete and click Delete.

Note: 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.

Requesting feature access

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 via email that a request is pending approval.

Granting feature access

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.

Note: 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. 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.

 

Teammates and API Keys

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.


Note: API Keys and Teammates can be used as 2 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 UI but full access to API Keys cannot make an API call to modify their permissions in the user interface.

 

Have more questions? Submit a request