Skip to main content
This section covers all aspects of administering your Checkly account, from managing team members and permissions to setting up advanced security features and API access.

​
Team Member Roles

Checkly has five built-in roles: Owner, Admin, Read & Write, Read & Run, and Read Only. Each role inherits all permissions from the roles below it. If custom roles (beta) are enabled for your account, you can also define roles with the permissions you pick. Each account has one Owner. The account creator is the Owner until they transfer ownership. You can invite teammates with any other role. You can change a member’s role after they join.

​
Permissions and roles

Your account role grants permissions for actions on resources. Use the permissions reference to find each permission’s ID, name in the role editor, description, and how to request access.

​
Choosing the Right Role

​
Adding Team Members

Learn how to invite new users to your account. Learn more about adding team members

​
Managing Team Members

Change members’ roles, remove members and invitations, change your own role, or leave an account. Learn more about managing team members

​
Transferring Ownership

Owners can transfer ownership to another team member from the General section in account settings:
  1. Make sure the new Owner is a member of the account. If they aren’t yet, invite them and wait until they accept. Pending invitations can’t receive ownership.
  2. In the Transfer ownership section, click “Transfer ownership”.
  3. Pick the new Owner by their email address and click “Transfer ownership”.
The new Owner gets the role right away. They don’t need to accept the transfer. Your role will change to Admin after the transfer.
  • Only the Owner can transfer ownership. Admins can’t make themselves the Owner.
  • The button is disabled while you’re the only member of the account.
  • If your account is managed through the Vercel native integration, transfer ownership in your integration settings on Vercel.
  • The account name doesn’t change with the transfer.
After the transfer, you can leave the account, or the new Owner can remove you. User API keys stop working for the account when their user leaves it. Use service API keys for automation that shouldn’t depend on one member. To move ownership to another email address, for example a shared team mailbox, invite that address, transfer ownership to it, and then remove your old user. See Changing your email. If the current Owner is no longer at your company or can no longer access Checkly, reach out to support@checklyhq.com and we can transfer ownership for you. To verify that you’re authorized to request the change, we’ll ask you to provide a previous Checkly receipt or invoice.

​
Account Management

​
Account name

The account Owner can change the account name from the General section in account settings. By default the account name is the Owner’s email address, but you can change it to reflect a department, product team, etc. set account name

​
Email and Password Changes

Manage your login credentials and account information securely. Learn about changing your email or password

​
Security

​
Multi-Factor Authentication

Add an extra layer of security to your account with MFA using authenticator apps. Set up multi-factor authentication

​
Single Sign-On (SSO)

For enterprise customers, Checkly supports SSO integration with your existing identity provider. Learn about SSO options

​
API Access

​
Creating API Keys

Generate API keys for programmatic access to your Checkly account through the REST API and CLI. Learn about creating and managing API keys API Key Types:
  • User API Keys - Tied to individual users with inherited permissions
  • Service API Keys - Account-level keys for CI/CD and automation (Starter, Team, and Enterprise plans)

​
Getting Help

If you need assistance with any administrative tasks or have questions about account management, please contact Checkly Support.