---
title: Roles and Permissions for Users and API Keys
description: "How roles work in OpusDNS: built-in roles, custom roles with read, manage and delete permissions, and roles for users and API keys."
---

[Skip to content](https://help.opusdns.com/roles-permissions#main-content)

- [English](https://help.opusdns.com/roles-permissions)
- [Deutsch](https://help.opusdns.com/de/roles-permissions)

English

Show submenu for translations

[![opusdns.com](https://help.opusdns.com/hs-fs/hubfs/v2-Status%20Center.png?width=180&height=51&name=v2-Status%20Center.png)](https://help.opusdns.com/?hsLang=en)

Open main navigation

Close main navigation

- - [English](https://help.opusdns.com/roles-permissions)
    - [Deutsch](https://help.opusdns.com/de/roles-permissions)

  English
  
  Show submenu for translations
- [Submit Ticket](https://support.opusdns.com/)

[Submit Ticket](https://support.opusdns.com/?hsLang=en)

 How can we help?

- There are no suggestions because the search field is empty.

1. [OpusDNS Knowledgebase](https://help.opusdns.com/?hsLang=en)
2. [OpusDNS Dashboard](https://help.opusdns.com/opusdns-dashboard?hsLang=en)
3. [User & Organization Management](https://help.opusdns.com/opusdns-dashboard?hsLang=en#user-organization-management)

November 15, 2026

# Roles and Permissions for Users and API Keys

## Use the built-in roles or create your own, and give every user and API key only the access it needs

A role decides what a user or an API key may do in your organization. OpusDNS comes with built-in roles for the most common tasks, and you can create custom roles with exactly the permissions you need.

 

### Where to Find It

**Path:** Left sidebar → Settings → Roles

**Direct URL:** `/settings/roles`

 

### Built-in roles

Built-in roles are maintained by OpusDNS and cannot be edited or deleted.

- **Owner:** full access. This is the first user of the organization. The owner role is set when the organization is created and cannot be assigned or changed.
- **Admin:** full access to everything in the organization.
- **Viewer:** read-only access to domains, DNS, contacts, hosts, forwarding, parking, events, jobs, users and audit logs.
- **Domain Manager:** full access to domains, DNS, contacts, hosts, email and domain forwarding, parking, events and jobs.
- **DNS Manager:** full access to DNS zones, email forwarding and domain forwarding.
- **Billing Manager:** read and manage billing.

To see exactly what a role allows, click **View permissions** next to it.

 

### Create a custom role

1. Go to **Settings → Roles** and click **Add role**.
2. Enter a **Name**, for example `Support`, and an optional **Description**.
3. Under **Permissions**, tick what the role may do per area: **Read** (view), **Manage** (create and change) and **Delete**. Areas include domains, DNS, contacts, hosts, email forwards, domain forwards, parking, events, jobs, billing, users, API keys, registrar credentials, tags and audit logs.
4. Click **Create**.

When you change a custom role with **Edit role**, the new permissions apply immediately to every user and API key that holds it. A custom role cannot grant full admin access; use the built-in Admin role for that.

A role cannot be deleted while it is still assigned to a user or an API key. Give those users and keys another role first.

 

### Give a user a role

Go to **Settings → Users**. You can choose the role when you add a user with **Add User**, change it with **Edit user**, or pick it directly in the **Role** column of the list.

- Only the organization owner can give or take away the Admin role.
- You cannot change your own role.
- The last admin of an organization cannot be deleted.

 

### Give an API key a role

Every API key has its own role, independent of the user who created it. Choose it in the **Role** field when you create the key under **Developer → API Credentials → New API Credential**. Editing a key later only changes its name and description, so create a new key if it needs a different role. See [Creating API Credentials](https://help.opusdns.com/creating-api-credentials?hsLang=en).

Give every user and every API key the narrowest role that still does the job, for example **Viewer** for reporting tools or **DNS Manager** for a script that only updates DNS records.

 

### Sub-organizations

Roles belong to one organization. A user or API key in a sub-organization can only hold a role from that sub-organization. See [Sub-Organizations & User Management](https://help.opusdns.com/sub-organizations-easily-manage-multiple-organizations-departments-and-client-accounts?hsLang=en).

 

### Related

- [Choosing Who Receives Billing, Pricing and Abuse Emails](https://help.opusdns.com/notification-emails?hsLang=en)
- [Creating API Credentials](https://help.opusdns.com/creating-api-credentials?hsLang=en)

- [Create your OpusDNS account](https://help.opusdns.com/create-your-opusdns-account?hsLang=en#main-content)

    - [Open Your Account](https://help.opusdns.com/create-your-opusdns-account?hsLang=en#open-your-account)
    - [FAQ](https://help.opusdns.com/create-your-opusdns-account?hsLang=en#faq)
    - [Getting Help with your Registration](https://help.opusdns.com/create-your-opusdns-account?hsLang=en#getting-help-with-your-registration)
- [OpusDNS API](https://help.opusdns.com/opusdns-api?hsLang=en#main-content)

    - [Getting Started with the API](https://help.opusdns.com/opusdns-api?hsLang=en#getting-started-with-the-api)
    - [Sandbox Environment](https://help.opusdns.com/opusdns-api?hsLang=en#sandbox-environment)
    - [OpusDNS MCP Server](https://help.opusdns.com/opusdns-api?hsLang=en#opusdns-mcp-server)
    - [FAQ](https://help.opusdns.com/opusdns-api?hsLang=en#faq)
    - [Getting Help with the OpusDNS API](https://help.opusdns.com/opusdns-api?hsLang=en#getting-help-with-the-opusdns-api)
- [OpusDNS Dashboard](https://help.opusdns.com/opusdns-dashboard?hsLang=en#main-content)

    - [Getting Started](https://help.opusdns.com/opusdns-dashboard?hsLang=en#getting-started)
    - [Plans & Pricing](https://help.opusdns.com/opusdns-dashboard?hsLang=en#plans-pricing)
    - [Billing & Payments](https://help.opusdns.com/opusdns-dashboard?hsLang=en#billing-payments)
    - [User & Organization Management](https://help.opusdns.com/opusdns-dashboard?hsLang=en#user-organization-management)
    - [Whitelabeling](https://help.opusdns.com/opusdns-dashboard?hsLang=en#whitelabeling)
    - [Account & Settings](https://help.opusdns.com/opusdns-dashboard?hsLang=en#account-settings)
    - [Security](https://help.opusdns.com/opusdns-dashboard?hsLang=en#security)
    - [AI Concierge](https://help.opusdns.com/opusdns-dashboard?hsLang=en#ai-concierge)
    - [Managing Contacts](https://help.opusdns.com/opusdns-dashboard?hsLang=en#managing-contacts)
    - [Managing DNS Zones & Nameservers](https://help.opusdns.com/opusdns-dashboard?hsLang=en#managing-dns-zones-nameservers)
    - [Register & Transfer Domains](https://help.opusdns.com/opusdns-dashboard?hsLang=en#register-transfer-domains)
    - [Managing Domains](https://help.opusdns.com/opusdns-dashboard?hsLang=en#managing-domains)
    - [Bulk Jobs](https://help.opusdns.com/opusdns-dashboard?hsLang=en#bulk-jobs)
    - [Developer Area](https://help.opusdns.com/opusdns-dashboard?hsLang=en#developer-area)
    - [Dashboard Functionality](https://help.opusdns.com/opusdns-dashboard?hsLang=en#dashboard-functionality)
    - [Dashboard home page](https://help.opusdns.com/opusdns-dashboard?hsLang=en#dashboard-home-page)
- [Services & Features](https://help.opusdns.com/services-features?hsLang=en#main-content)

    - [Domain forwarding](https://help.opusdns.com/services-features?hsLang=en#domain-forwarding)
    - [Email forwarding](https://help.opusdns.com/services-features?hsLang=en#email-forwarding)
    - [Reports](https://help.opusdns.com/services-features?hsLang=en#reports)
    - [Domain parking](https://help.opusdns.com/services-features?hsLang=en#domain-parking)
    - [WHMCS Integration](https://help.opusdns.com/services-features?hsLang=en#whmcs-integration)
    - [Hostware Integration](https://help.opusdns.com/services-features?hsLang=en#hostware-integration)
    - [Terraform Integration](https://help.opusdns.com/services-features?hsLang=en#terraform-integration)
    - [GO Integration](https://help.opusdns.com/services-features?hsLang=en#go-integration)
    - [Certificate Management with ACME and OpusDNS](https://help.opusdns.com/services-features?hsLang=en#certificate-management-with-acme-and-opusdns)
- [New to the Domain Industry?](https://help.opusdns.com/new-to-the-domain-industry?hsLang=en#main-content)

    - [Everything about Domains](https://help.opusdns.com/new-to-the-domain-industry?hsLang=en#everything-about-domains)
    - [Domain Industry](https://help.opusdns.com/new-to-the-domain-industry?hsLang=en#domain-industry)
    - [Reseller Essentials](https://help.opusdns.com/new-to-the-domain-industry?hsLang=en#reseller-essentials)
- [TLD information](https://help.opusdns.com/tld-information?hsLang=en)

- [OpusDNS Homepage](https://www.opusdns.com/)
- [Legal Notice](https://www.opusdns.com/legal/notice-impressum)
- [Privacy Policy](https://www.opusdns.com/legal/privacy-policy)
- [Terms & Conditions](https://www.opusdns.com/legal/terms-conditions)

[![OpusDNS Homepage](https://help.opusdns.com/hubfs/6722ae7333e645c8919a4751_opusDNS-VT-3c-white-tagline.svg "OpusDNS Homepage")](https://www.opusdns.com/)

©2025 OpusDNS GmbH. All rights reserved.

<https://www.linkedin.com/company/opusdns/>

![icann](https://help.opusdns.com/hubfs/icann.svg).