Subusers
Info
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.
- Navigate to Settings and select Subuser Management.
- Select the name of the subuser. This takes you to the subuser's account and profile settings. From there, you can manage and update your subuser Settings.
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. |
Info
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.
- Log in to app.sendgrid.com.
- Navigate to Settings in the Twilio SendGrid app.
- Click Subuser Management.
- Locate the subuser account to disable.
- Click on the subuser's name to view their account details.
- Click Disable Account.
To re-enable a subuser's account, follow the previous steps 1-3, then click Enable Account.
Danger
You can't undo deleting a subuser account. Deleting this subuser results in immediate revocation of all Twilio SendGrid access.
- Log in to app.sendgrid.com.
- Navigate to Settings in the Twilio SendGrid app.
- Click Subuser Management.
- Locate the subuser account to delete.
- Click on the subuser's name to view their account details.
- On the Account Settings page, click Delete. A confirmation window displays.
- Click Confirm.
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.
- Log in to app.sendgrid.com.
- Navigate to Settings in the Twilio SendGrid app.
- Click Subuser Management.
- Click the subuser to which you want to link to a dedicated IP address.
- Click Change Sending.
- Under IP Addresses, select an IP address to link to the subuser.
- Click Save.
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.
- Log in to your SendGrid account with your Twilio login. A vertical navigation bar displays at the top.
- Go to the top navigation bar and click on the name of the SendGrid account. You find the account name in bold and within a white box to the right of the Twilio SendGrid logo.
- When the submenu appears, click View subusers.
- To impersonate a subuser, click that subuser's name.
This page refreshes. A yellow button displays Subuser to the right of the subuser's username.
Switch to another subuser account
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.
Return to your parent account
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.
- Log in to app.sendgrid.com.
- Navigate to Settings in the Twilio SendGrid app.
- Click Subuser Management.
- Click Export Data. This downloads a CSV file with each subuser's reputation as well as the number of requests they made for the current and last month.