Subusers help you segment your email sending and API activity. You assign permissions and credit limits when you create the subuser. We recommend creating subusers for each of the different types of emails you send - one subuser for transactional emails, and another for marketing emails. Breaking your sending up this way allows you to get separate statistics for each type of email you send.
If you have a Pro or Premier API plan or an Advanced Marketing Campaigns Plan, you may create up to 15 subusers through your account. If you reach the maximum of 15 and require more subusers, please use the form in the Subuser Management page to request more.
New SendGrid accounts do not come with subusers; you must create them with the parent account.
To create a subuser:
Enter the following required information into the corresponding fields:
Subusers can be managed via Subuser API or by using the SendGrid UI.
To manage a subuser from the SendGrid UI:
We do not require this information for your subusers, but we suggest that you fill out as much as possible to improve the deliverability for this subuser, especially if the information does not match your parent account’s information. This will also allow SendGrid to contact your subuser directly if we notice anything on their account.
The following fields in the subuser profile are optional:
First Name - The first name of the person responsible for this subuser.
Last Name - The last name of the person responsible for this subuser.
Company - The name of your subuser’s company.
Address 1 - The first line of your subuser’s address.
Address 2 - The second line of your subuser’s address.
City - The city in which your subuser operates.
State - The state or province in which your subuser operates.
Country - The country in which your subuser operates.
Zip - The zip code in which your subuser operates.
Company Phone Number - The phone number for your subuser’s business.
Company Website - The website for your subuser’s business.
You can only allocate credits by selecting the nonrecurring credit option.
If your Subuser account has nonrecurring credits, you can allocate credits to, or remove credits from this subuser account. On the subuser's profile, click Change Credit Rules and then choose the appropriate credit amount for the subuser.
This feature allows you to receive a sample of a subuser's email content to help ensure that the content is not damaging your reputation.
Each monitor email costs one email credit.
The “Collect Sample Rate” is the number of emails SendGrid will allow through before copying the email address you set on the next email sent. For example, if you set the collect sample rate at 100, then you will receive a copy of every 100th email this subuser sends.
To turn off a subuser’s access to SendGrid temporarily:
To re-enable a subuser’s account, follow steps 1 and 2 above, then click Enable Account.
Deleting a subuser account cannot be undone. Please make sure that you are ready to delete this account before you delete it. Deleting this subuser will immediately revoke all access.
To delete a subuser account:
You will need to have a dedicated IP address already. Adding subusers to dedicated IP addresses can help you separate your sending traffic, improving your deliverability rate.
When you set up subusers, it may be useful to see what the subuser’s settings are and to see what the subuser can see in the SendGrid UI. To make this easier, we’ve made it so you can impersonate a subuser from your parent account and then manage the subuser the same way as if you had logged in with that user’s credentials, without having to log out of your parent account.
To impersonate a Subuser:
The page will refresh, and you will notice a message at the top of the screen that says, “You're currently logged in as [subuser name]”.
If you have more than one subuser, you can also switch to another subuser by clicking Switch Subuser in the top-right corner once you are impersonating any subuser.
Click the link at the top left that says “Back to Parent Account”. This will log you out of the subuser account and take you back to your parent account portal.
If you would like to see how your subusers are performing in comparison to each other, you can export subuser data.
To export subuser information:
Let us know how we’re doing! Please rate this page:
Please note, we cannot resolve account and login issues reported on GitHub. Contact support for account assistance.
Thanks for helping us improve our docs!