How to create a Cloudflare API token with the narrowest permissions

Shipyard uses a Cloudflare token for domain registrar, dns and cdn, mailbox for the domain and file storage. The token is stored in your computer's keychain and is not sent to shipyardmcp.com. These are the exact steps, and the smallest set of permissions that works.

Create the token

Start here: https://dash.cloudflare.com/profile/api-tokens

  1. Open the link. The name Shipyard and four of the seven permissions are already filled in. If the page opens empty instead, press Create Token, name it Shipyard and press "Start from scratch (Custom)".
  2. Account policy (if you are asked, pick "Start with an Account policy" and choose your account). It needs four permissions: Registrar: Domains (found under DNS & Zones; tick Admin, and leave Registrar Sandbox Domains alone), Email Routing Addresses, Workers R2 Storage and API Tokens. Add the ones that are missing.
  3. Zone policy (press "+ Add new policy" under the list, pick "Start with a Zone policy", and leave it on all zones). It needs three permissions: Zone, DNS and Email Routing Rules. Add the ones that are missing.
  4. Finding a permission: type its name in the "Search for permission groups" box of that policy. Without searching, they sit under these headings: Registrar: Domains under DNS & Zones, Email Routing Addresses under Email & Messaging, Workers R2 Storage under Developer Platform, API Tokens under Account & Billing.
  5. Each permission has two boxes. Always tick the right-hand one: it is called Edit on most and Admin on some. Read alone is not enough.
  6. Do not pick "Start with a User policy".
  7. Token expiration: leave "No expiration". Client IP address filtering: leave empty.
  8. Press Continue to summary. Check that it shows two blocks: one with the four account permissions and one with the three zone permissions. If the zone block is missing, press Back and use "Add new policy".
  9. Press Create Token and copy it. Cloudflare shows it only once.
  10. Paste it into Shipyard. Leave the Account ID question empty: Shipyard finds it. It only asks you to choose if your login has more than one Cloudflare account.

Permissions, and why each one is needed

Set up once in Cloudflare before your first launch

What stays manual

These are things only a person can do at this provider. Shipyard cannot and will not do them for you.

What you paste into Shipyard

Have this set up for you

Shipyard connects your accounts once and then does all of this for every new product, in about an hour.

See how it works

Related guides

How to create a Cloudflare API token with the narrowest permissions – Shipyard