Subusers - Twilio - SendGrid Documentation

Subusers – Twilio – SendGrid Documentation

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.
Create a subuser
New SendGrid accounts do not come with subusers; you must create them with the parent account.
To create a subuser:
Navigate to Settings and select Subuser Management.
Click Create New Subuser.
Enter the following required information into the corresponding fields:
Username – The username your subuser will use to send emails and access the API.
Email Address – The contact email address for this subuser. This must be an active email account as SendGrid may contact a subuser to provide support, resolve sending and deliverability issues, or to enforce SendGrid’s Terms of Service. Whenever we contact a subuser, it is our policy to contact the parent account email address at the same time.
Password – The password your subuser will use to access
Avatar – If you have gravatar, or globally recognized avatar, that you use for other applications, it is automatically associated with this subuser when you enter an email address. This makes it easier to identify all of the subusers attached to your account.
Assign an IP Address to the subuser account.
You are assigned 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.
Manage subusers
Subusers can be managed via Subuser API or by using the SendGrid UI.
To manage a subuser from the SendGrid UI:
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.
Optional Profile Information
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.
Allocating or removing credits from a subuser
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.
Monitoring subuser email content
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.
Disabling a subuser account
To turn off a subuser’s access to SendGrid temporarily:
Locate the subuser account you wish to disable and click on the name to view the account details.
Click Disable Account.
To re-enable a subuser’s account, follow steps 1 and 2 above, then click Enable Account.
Deleting a subuser 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:
Locate the subuser account you wish to delete and click on the name to view the account details.
On the Account Settings page, click Delete.
A confirmation window appears.
Click Confirm to delete the subuser account.
Adding subusers to Dedicated IP Addresses
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.
Select the subuser to assign the dedicated IP.
Select Change Sending.
Under IP Addresses, select an IP address to assign to the subuser.
Select Save.
Impersonating a Subuser
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:
Log into SendGrid.
Go to the top left corner of the portal screen and click on your name just above the navigation menu.
Click Switch User.
Choose the subuser you want to impersonate by clicking that subuser’s name.
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.
Switching back to your parent account
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.
Export subuser Information
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:
Click Export Data.
This downloads a CSV file with each subuser’s reputation, the number of requests they made this month, and the number of requests they made last month.
Additional Resources
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.
Tutorial: How to Create a SendGrid Subuser

Tutorial: How to Create a SendGrid Subuser

Our VidGrid Tutorial we have for you today is all about creating subusers within your SendGrid account. Subusers are child accounts that share the same overall credit pool as the parent account, but have their own unique SMTP credentials, settings, statistics, and site login. The video below takes you through the process of creating subusers from start to finish.
Video Transcription
SendGrid support here, bringing you a video about subusers without sender authentication. Subusers are child accounts available for all silver level and higher customers. Subusers share the same overall credit pool but have their own unique SMTP credentials, settings, stats, and site login.
Things to Remember When Creating a Subuser
Here are some important notes before you move forward with the subuser creation:
The subuser creation process must be completed in one single go. If you happen to exit out of the subuser creation or log out of your account, you will need to start over before the subuser account is completed.
Creating a subuser that uses the parent account IP and sender authentication results via or on the behalf of message displaying in some of the email plans if you use a firm domain that does not match the authenticated domain. It is important to change the DKIM app settings for the subuser accounts to match the parent account’s authenticated domains.
Create a Subuser on Your Account
Now that we have gone over all the important notes, let’s move forward and create a subuser. On your account overview page you will notice on the right of the screen that you will see an account overview, below will be the Subuser Management. Once clicked, you will land on this page- Subuser Management. From here you can manage new and old subusers. In this case we are going to create a new subuser. On the top of the page you will notice that you’ll see a little man with a new subuser line next to it. Let’s go ahead and click on that link. Now you’ll land on a user management page, which is step one of six other steps that you must complete before having the subuser created.
Step 1:
On the account information page, like your parent account you will need to fill it out with the most accurate information as possible when creating the subuser. In this case my user name is Anthony. There may be other users on the SendGrid system with a similar user name, so let’s create something very unique. Once all the other information is completed you will want to scroll down to the very bottom of the page. To the left, you will see “I agree to the terms of service, ” and you will want to click that to move forward. Once clicked and all the other information has been filled out, you will want to move forward and proceed to Step 2- IP Selection.
Step 2:
Let’s click on the button. Step 2- IP selection lets you choose the IP you would like to send from. In this case we’re going to choose the IP of our parent account. Once checked, you will want to move forward and click Step 3- Quick Setup.
Step 3:
The Quick setup page will allow you to choose any previous or new authenticated domains that you want to create. In this case, we’re going to be using the parent authenticated domains. Let’s go ahead and select the one that I’ve used in the past. Once selected, you’re going to move to Step 4- Domain Information.
Step 4:
Domain information pretty much confirms settings of all the information that you went through on the other steps. Once all the information looks accurate you’re going to want to scroll down and click the finish button. After you click the finish button you’ll now notice that it brings you back to the subuser management page and you’ll see the new subuser. From here, you have the ability to either edit or delete the subuser.
You have now completed all the necessary steps to creating a new SendGrid subuser!
Subusers are available to all Silver accounts and above. To learn more about our Silver plan please click here.
Subuser Management - Twilio - SendGrid Documentation

Subuser Management – Twilio – SendGrid Documentation

These calls allow the creation, management, and deletion of subusers.
In both creating and searching for a subuser, use the username parameter. In other API calls, use the user parameter. When creating a subuser, there is no existing user parameter to reference, and one is being created.
Create a Subuser
URI Parameter
No more than 64 characters
New subuser username
See SendGrid password requirements
New subuser password
Match password argument
Confirm new password
Valid email address, no more than 64 characters
New subuser email. This is an administrative contact address for SendGrid
No more than 50 characters
New subuser profile first name
New subuser profile last name
No more than 100 characters
New subuser profile street address
New subuser profile city
New subuser profile state
New subuser profile postal code
Valid ISO 3166-1 alpha-2 country code
New subuser profile country code
New subuser profile phone number
No more than 255 characters
New subuser profile website
New subuser profile company name
Existing domain authentication record on the parent user
New subuser authenticated domain. Be mindful of IP assignment in relation to authenticated domain record
api_user=your_sendgrid_username&api_key=your_sendgrid_password&username=subuser_username&”123 Sesame Street”&city=”New York”&state=NY&zip=10128&”(999) 555-5555″


Delete a Subuser
This call will delete a subuser and will disable all tracked links on sent messages. Recipients will no longer be able to click existing tracked links and make it to the intended destination. This is irreversible, and should be used with extreme caution.
Must be existing subuser name
Subuser to delete
Retrieve Subusers
Obtain a list of subusers under your account.
Must be set to get
Task to get list of subusers
Valid username format
Optional string to filter results
Valid email format
0 or 1
Optional flag to filter results
Valid first_name format
Valid last_name format
Valid street address format
Valid city format
Valid state format
Valid country format
Valid zip format
Valid phone format
Valid website format
Valid company format
“username”: “username”,
“email”: “”,
“active”: “true”,
“first_name”: “john”,
“last_name”: “doe”,
“address”: “555 any street”,
“city”: “any city”,
“state”: “CA”,
“zip”: “91234”,
“country”: “US”,
“phone”: “555-555-5555”,
“website”: “”},
“active”: “false”,
“first_name”: “jane”,
“website”: “”}]



555 any street

any city
US 555-555-5555


Update Subuser Username
Subuser username is used to access website and API. Changes occur immediately.
Must be set to setUsername
Task to update subuser username
Subuser must be under your account
Subuser to update username of
New username for subuser
Update Subuser Password
Passwords are stored encrypted, and cannot be retrieved. Forgotten passwords must be updated.
Subuser to update password of
New password for subuser
Update Subuser Email Address
This is the administrative contact address, used by SendGrid to contact the user. Unrelated to sending address information.
Must be set to setEmail
Task to update subuser email address
Subuser to update email address of
New administrative contact address
Update Subuser Profile
Update Subuser profile information.
Must be set to set
Task to update subuser profile
Subuser to update profile
Disable a Subuser
Sets subuser’s active flag to 0. Prevents subuser from sending email. Does not affect website login permissions.
Subuser to disable email permissions
Enable a Subuser
Sets subuser’s active flag to 1. Allows subuser to send email. Does not affect website login permissions. New subusers are set to active by default.
Subuser to enable email permissions
Disable Website Access To A Subuser
When you disable website access for a Subuser, website access will also be disabled for all of that Subuser’s Teammates.
Disallow a subuser to login to the SendGrid website. Does not affect email sending permissions.
Subuser to disable website access
Enable Website Access To A Subuser
Allow a subuser to login to the SendGrid website. Does not affect email sending permissions. New subusers are enabled by default.
Subuser to enable website access
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.

Frequently Asked Questions about subuser

What is a Subuser?

Subusers are child accounts available for all Premium, Corporate and Professional accounts. Subusers act under the same account as the administrator, but cannot see nor manage the posts published by the administrator or other subusers of the account.

What is Subuser in SendGrid?

Our VidGrid Tutorial we have for you today is all about creating subusers within your SendGrid account. Subusers are child accounts that share the same overall credit pool as the parent account, but have their own unique SMTP credentials, settings, statistics, and site login.Nov 8, 2013

How do I give someone access to ClickFunnels?

To begin, you will need to have received an invitation from a current ClickFunnels account owner. Check your mail folder for the invitation email. After opening the email, click the Accept Invite button.Jun 9, 2021

About the author


If you 're a SEO / IM geek like us then you'll love our updates and our website. Follow us for the latest news in the world of web automation tools & proxy servers!

By proxyreview

Recent Posts

Useful Tools