Subusers require a paid Twilio SendGrid account. 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 require more subusers, submit a ticket at Twilio SendGrid Support.
Subusers help you segment your email sending and API activity. When you create the subuser, you can assign it permissions and credit limits. Consider creating subusers for each type of email you send: one subuser for transactional emails and another for marketing emails. This allows you to generate separate statistics for each type.
By default, new Twilio SendGrid accounts don't include subusers. To create subusers, use the parent account.
To create a new subuser, follow these steps.
Log in to app.sendgrid.com.
Navigate to Settings in the Twilio SendGrid app.
Click Subuser Management.
Click Create New Subuser.
Enter the username that your subuser uses to access the app and the API into the Username field.
Enter a valid contact email address for this subuser into the Email Address field. This must be an active email account as Twilio may contact a subuser to provide support, resolve sending and deliverability issues, or to enforce Twilio's Terms of Service. Whenever we contact a subuser, we contact the parent account at their email address at the same time.
If you use a gravatar for other applications, Twilio adds it to the Avatar field. Twilio associates the gravatar with this subuser when you enter a linked email address. This simplifies identifying all of the subusers attached to your account.
Enter the password associated with the subuser's username in the Password field.
Assign an IP Address to the subuser account. Twilio assigns you a dedicated IP address when you create a Pro 100k plan or higher. If you send at a high volume, and you're using subusers to separate out your sending traffic, it's best practice to purchase a separate IP for each sending type.
To manage a subuser from the SendGrid app, follow these steps.
You can also manage subusers with Subuser API.
If the data doesn't match your parent account's data, providing this data for this subuser improves deliverability. If an issue arises with the subuser's account, Twilio can contact your subuser to resolve it.
Optional data for a subuser profile includes the following fields.
| Field | Intended Value |
|---|---|
| First Name | Given name of the person responsible for this subuser. |
| Last Name | Surname of the person responsible for this subuser. |
| Company | Name of your subuser's company. |
| Address 1 | First line of your subuser's business address. |
| Address 2 | Second line of your subuser's business address. |
| City | City of your subuser's business address. |
| State | State or province of your subuser's business address. |
| Country | Country of your subuser's business address. |
| Zip | Postal code of your subuser's business address. |
| Company Phone Number | Phone number for your subuser's business. |
| Company Website | Website for your subuser's business. |
To allocate credits, select the nonrecurring or recurring credit option.
If your subuser account has non-recurring or recurring 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.
You may assign more credits to your subuser regardless of having the recurring option on Change Credit Limits.
To turn off a subuser's access to SendGrid on a temporary basis, follow these steps.
To re-enable a subuser's account, follow the previous steps 1-3, then click Enable Account.
You can't undo deleting a subuser account. Deleting this subuser results in immediate revocation of all Twilio SendGrid access.
The deleted subuser loses all Twilio SendGrid access.
Linking subusers to dedicated IP addresses can help separate your sending traffic and improve your deliverability rate.
When you set up subusers, you may want to see the subuser's settings and their view of the SendGrid UI.
To simplify this, you can impersonate a subuser from your parent account. From there, you can manage the subuser the same way as if you had logged in with that user's credentials. This doesn't require you to log out of your parent account.
This page refreshes. A yellow button displays Subuser to the right of the subuser's username.
If you have more than one subuser, you can switch to another subuser. To impersonate a different subuser, repeat steps 2-4 in the previous section.
Under the Account Name submenu, click View all accounts. Click the name of your parent account. This returns you to your parent account portal.
To compare the performance of your subusers, download the subuser data.