How to give an agency access to your Cloudflare account
Updated By Adcato
In Cloudflare, a Super Administrator goes to the Members page, selects Invite members, enters the agency person's email address and creates a permission policy: a scope, such as one domain, and one or more roles. For an agency that only needs to add DNS records, for example to verify your domain with Meta or Google, the domain-scoped Domain DNS role on that one domain grants access to edit its DNS settings. The person accepts the email invitation, and you can remove them from the same page.
This guide is for the business that owns the Cloudflare account. The agency only has to send the email address of each person who needs access.
Before you start
- You need the Super Administrator role and a verified email address. Cloudflare's members page requires both to manage members. The Administrator role cannot manage members.
- Access is a policy. Each policy has one scope (the whole account, chosen domains, a domain group or single resources) and one or more roles. A person can have several policies, and their access is all of them added together.
- Decide what the agency touches. One domain or every domain, and DNS only or the whole site's settings.
Invite the agency person
Cloudflare's steps:
- In the Cloudflare dashboard, go to the Members page.
- Select Invite members.
- Under Add email addresses, enter the agency person's email address. Separate several addresses with commas.
- Under Add permission policies, choose the scope: the entire account, or specific resources such as individual domains.
- Select one or more roles.
- Select Create policy. Repeat steps 4 to 6 for another scope if needed.
- Select Invite members.
The person appears on the Members page with the status Pending until they accept the email invitation. On an Enterprise account, Cloudflare also offers Skip email confirmation for someone who already has a Cloudflare account.
Which scope and role to give
The scope decides which roles you can pick. Cloudflare's scope page says a policy for All domains takes only account-scoped roles, and a policy for a specific domain takes only domain-scoped roles.
Domain-scoped roles, from Cloudflare's roles page:
- Domain DNS: edit DNS settings for the domain.
- Cache Domain Purge: purge the cache for the domain and read its settings.
- Domain Administrator Read Only: read-only access to the domain.
- Domain Administrator: full access to the domain, and read-only access to account-wide Firewall, Access and Worker resources.
Account-scoped roles an agency may ask for:
- DNS: edit DNS records, across the account.
- Administrator Read Only: the full account in read-only mode.
- Administrator: the full account and its subscriptions, but not members or the billing profile.
- Super Administrator - All Privileges: every setting, purchases, billing and members. Cloudflare says Super Administrators can revoke the access of other Super Administrators.
Our advice, based on those descriptions:
- An agency that verifies a domain or adds a record: Specific domains, that domain, Domain DNS.
- A web agency that runs the site on Cloudflare: Specific domains, the site's domain, Domain Administrator.
- An agency that only reviews your setup: Domain Administrator Read Only on the domains it reviews.
- Super Administrator: keep it in your business. An agency with it could remove you.
The agency person accepts
Cloudflare emails the invitation. If the person cannot find it, or it has expired, open the Members page, find the row with the status Pending, and select ... > Resend invite.
Check, change or remove the agency's access
- See who has access: the Members page shows each member's invitation status, Super Administrator status, API access setting and whether two-factor authentication is on. A member's details show every policy they have, including those from user groups.
- Change the access: on the member's row, select ... > View & Edit permission policies. On the Permission policies tab, create, edit or delete a policy.
- Block the API: on the member's row, select ... > Manage member settings, and under API access for this member choose Block access.
- Remove the agency: on the member's row, select ... > Remove member, then Remove member in the confirmation dialog. The same steps cancel a pending invitation.
The agency person can also leave by itself: on its own row of the Members page, ... > Leave account.
If the agency is the Super Administrator
This happens when an agency set up Cloudflare for you. Cloudflare's Super Administrator page gives the order: first add a member with the Super Administrator role, then remove the previous one if needed. Ask the agency to invite you as Super Administrator. Once you have accepted, lower the agency's role or remove it. Cloudflare recommends having more than one Super Administrator, so keep a second person from your business on that role.
If your domain is in the agency's Cloudflare account
To have it in your own account, the domain has to move. Cloudflare's move article gives these steps for a domain whose nameservers point to Cloudflare:
- The agency removes any DNSSEC configuration and disables any zone holds on the domain in its account.
- The agency exports the DNS records from its account. Cloudflare recommends this; without it, the new account imports proxied records that can cause a 1000 error.
- In your own Cloudflare account, add the domain as if for the first time, and import the records.
- At your domain registrar, change the nameservers to the ones Cloudflare gives you.
- Select the domain, then Overview > Re-check now.
- When the domain shows Active in your account, the agency cancels any add-ons or subscriptions on it in its account.
SSL/TLS certificates do not move with the domain. In the agency's account, the domain shows Moved Away, then Deleted after seven days, and is removed seven days after that. If the domain is registered with Cloudflare Registrar, Cloudflare says the registration needs a manual transfer request.
Troubleshooting
You cannot invite anyone
Managing members needs the Super Administrator role and a verified email address. Administrator is not enough.
The role you want is not in the list
The scope decides the roles. Domain roles such as Domain DNS appear with a specific domain as the scope, and account roles such as DNS with All domains.
The agency never got the invitation
Select ... > Resend invite on its row, which has the status Pending.
The agency can still change other domains
Its access is the sum of all its policies, including those from user groups. Open its details from the Members page and remove the policy that covers the other domains.
Questions
Which role does an agency need to verify my domain with Meta or Google?
If the verification uses a DNS record, the domain-scoped Domain DNS role, on that one domain, grants access to edit its DNS settings. You can also add the record yourself and skip giving access.
Can I limit the agency to one domain?
Yes. Choose Specific domains as the policy's scope and pick the domain. Only domain-scoped roles can be used with that scope.
What is the difference between Administrator and Super Administrator?
Cloudflare's Administrator can access the full account and edit subscriptions, but cannot manage members or the billing profile. A Super Administrator can edit any setting, make purchases, update billing and manage members, including revoking other Super Administrators.
Can I stop the agency from using Cloudflare's API?
Yes. On the Members page, open the member's menu, select Manage member settings and choose Block access under API access for this member.
Checked against
- Manage account members (Cloudflare Fundamentals docs), read
- Roles (Cloudflare Fundamentals docs), read
- Role scopes (Cloudflare Fundamentals docs), read
- Policies (Cloudflare Fundamentals docs), read
- Change Super Administrator (Cloudflare Fundamentals docs), read
- Move a domain between Cloudflare accounts (Cloudflare Fundamentals docs), read