Connecting Cloudflare
Link your Cloudflare account to Zynnode with an API token.
Zynnode connects to Cloudflare using an API token and your Account ID. This lets Zynnode deploy your apps to Cloudflare Pages on your behalf. The setup takes about two minutes.
Prerequisites
- A Cloudflare account (free tier works)
- Access to the Cloudflare dashboard at dash.cloudflare.com
Step-by-Step Setup
Start the Connection in Zynnode
During the new project wizard, select Cloudflare as your cloud provider. You'll see a form asking for:
- Connection Name — A friendly label (e.g., "My Cloudflare Account")
- Account ID — Your Cloudflare account identifier
- API Token — A restricted token with the right permissions
The next steps show you where to find each value in the Cloudflare dashboard.
Find Your Account ID
- Open the Cloudflare Dashboard.
- In the left sidebar, click Workers & Pages.
- On the right side of the page, you'll see a section labeled Account details.
- Copy the Account ID value. It looks like a long string of letters and numbers (e.g.,
a1b2c3d4e5f6...). - Paste it into the Account ID field in Zynnode.
Create an API Token
Zynnode needs an API token with specific permissions to manage your Cloudflare Pages projects.
- In the Cloudflare dashboard, click your profile icon in the top-right corner.
- Click My Profile.
- In the left sidebar, click API Tokens.
- Click the Create Token button.
- Scroll down and click Get started next to Create Custom Token.
Now configure the token permissions:
- Give the token a name, like
Zynnode Deploy Token. - Under Permissions, add the following two rules:
- Account → Cloudflare Pages → Edit
- Account → Account Settings → Read
- Under Account Resources, select Include → All accounts (or choose a specific account if you have multiple).
- Click Continue to summary.
- Review the permissions and click Create Token.
- Copy the token immediately — Cloudflare will only show it once.
- Paste it into the API Token field in Zynnode.
Copy your API token right away. Cloudflare won't show it again after you leave the page. If you lose it, you'll need to create a new one.
Save the Connection
- Make sure all three fields are filled in: Connection Name, Account ID, and API Token.
- Click Connect in Zynnode.
- Zynnode will verify the credentials. If everything is correct, you'll see a green success message and can proceed with your deployment.
If you've already connected Cloudflare in a previous project, Zynnode will automatically detect the existing connection and skip this step.
Troubleshooting
"Invalid API token" error
- Make sure you copied the full token with no extra spaces.
- Verify the token has the correct permissions: Cloudflare Pages (Edit) and Account Settings (Read).
- Check that the token hasn't expired. In Cloudflare, go to My Profile → API Tokens and check the token's status.
"Account ID not found" error
- Double-check you copied the Account ID from Workers & Pages → Account details, not a Zone ID.
- Zone IDs and Account IDs look similar but are different. The Account ID is under your main account, not under a specific domain.
I want to change or remove the connection
To update the connection, remove it from the Zynnode dashboard and create a new one with updated credentials.
To revoke Zynnode's access on the Cloudflare side:
- Go to My Profile → API Tokens in the Cloudflare dashboard.
- Find the token you created for Zynnode.
- Click the three dots (⋯) menu and select Delete.