Back to main menu


Introducing the 5 user roles: Keep the riffraff out of your Mailgun account

With Mailgun's sub-user functionality, you can set up an Admin account and grant permission to members of your team who only need reporting or billing access.



Introducing role-based access control for dashboard users. You can finally get some sleep at night knowing that a rogue marketer isn’t messing with your Mailgun account.

With these new user management features, you can better map a user’s Mailgun access to the privileges they need for their job responsibilities.

We added multi-user accounts a couple years ago, but every user was given full access to everything in Mailgun. Now, with this subuser functionality, you’ll be able to set up a Mailgun account as an “Admin,” then grant permission to various people in your organization who can only view reports or manage billing, for instance.

It reduces the risk of account compromise, and it gives you more control over what users can (and can’t) access. Plus, it makes the dashboard experience more straightforward for folks from marketing and accounting who think APIs are great and all but have no idea what they actually are.

Sign Up

It's easy to get started. And it's free.

See what you can accomplish with the world’s best email delivery platform.

The 5 permission levels

We’ve added several additional roles so you can safely expand access to other members of your team who could benefit from a few guardrails. Each user on your account can belong to one of the following roles:

Picture of Mailgun staff with their roles labelled beneath them

Analyst: Analyst users have limited access to the control panel. They are allowed to read most data in the dashboard, except for sensitive information like API keys and SMTP passwords. We’ve designed this role for marketers, product managers, and other users who would like access to reporting features.

Billing: Billing users can change payment settings, review invoices, and inquire about billing issues, but they will not be able to make account-level changes. Many organizations have billing administrators who are responsible for managing spend and paying invoices, and this role is for them.

Support: In addition to read privileges, support users have the ability to edit suppressions, manage mailing list members, and open/comment on support tickets. This role is designed for users in your organization who may need to troubleshoot deliverability issues for recipients.

Developer: Developer users have access to read API keys and SMTP credentials so they can configure applications that are leveraging Mailgun. It’s a highly trusted role that has the ability to manipulate most settings on the account, except for editing account details and managing control panel users, API keys, and SMTP credentials.

Admin: Admin users have full access to the account. They can add and remove dashboard users, manage credentials, and do everything a Developer user can do. In other words, they can do everything.

So why these five roles? Why not 5,000? The short answer is that we wanted to keep user management simple. To do that, we looked at the most common tasks our non-developer users were doing in Mailgun and created roles that would give them just enough permissions to get the job done. We could have come up with thousands of configurable options to solve for every use case, but that would have overcomplicated something that needs to be straightforward.

Account ownership updates

As part of this release, we’ve also provided additional features to manage the owner of the account. There can only be one owner per account, but the existing account owner can transfer ownership to another account user. Account owners receive all account communication and can’t be removed by any other user on the account.

How to manage user roles

Role-based access control is rolling out today, but you won’t notice much of a difference unless you manage your account settings. All current users will become Admin-level users by default.

To assign different roles to your account’s users, please visit the Account section of the control panel. There, you can choose the appropriate permissions level for each user. And when it’s time to add new users to your account, you’ll be able to easily select a role upon user creation. You can also find information about managing user roles in the docs.

Don’t yet have a Mailgun account? Sign up now. Mailgun makes it easy to send, receive, and track your transactional and marketing emails. Try us out with your app!

Sign Up

It's easy to get started. And it's free.

See what you can accomplish with the world’s best email delivery platform.

Related readings

An expanded Mailgun product suite to transform email deliverability

Today marks a special day for Sinch Mailgun. For over a decade, our focus has been to provide the best email experience for businesses all around the world. Now, we take...

Read more

Forrester TEI study reveals Sinch Mailgun ROI and outcomes

When an enterprise starts working with Sinch Mailgun, what’s the financial impact that choice has on the business? It’s a good question – but not exactly an easy one to answer...

Read more

Privacy, automatic engagements, and Mailgun’s bot detection

Now more than ever, users are concerned about their data privacy and what steps they can take to protect their personal information. And that’s something big players in the tech...

Read more

Popular posts

Email inbox.

Build Laravel 10 email authentication with Mailgun and Digital Ocean

When it was first released, Laravel version 5.7 added a new capability to verify user’s emails. If you’ve ever run php artisan make:auth within a Laravel app you’ll know the...

Read more

Mailgun statistics.

Sending email using the Mailgun PHP API

It’s been a while since the Mailgun PHP SDK came around, and we’ve seen lots of changes: new functionalities, new integrations built on top, new API endpoints…yet the core of PHP...

Read more

Statistics on deliverability.

Here’s everything you need to know about DNS blocklists

The word “blocklist” can almost seem like something out of a movie – a little dramatic, silly, and a little unreal. Unfortunately, in the real world, blocklists are definitely something you...

Read more

See what you can accomplish with the world's best email delivery platform. It's easy to get started.Let's get sending
CTA icon