Skip to content

Cloudflare Connection ​

AwaitStep deploys workflows to your Cloudflare account using a scoped API token. You create the token once and paste it into the AwaitStep UI.

Create a Custom API token ​

  1. Open the Cloudflare API Tokens page.
  2. Click Create Token.
  3. Click Get started next to Create Custom Token (do not use a template).
  4. Give the token a descriptive name, e.g. AwaitStep Deploy.
  5. Under Permissions, add the following:
ScopeResourcePermission
AccountWorkers ScriptsEdit
ZoneWorkers RoutesEdit
AccountWorkers TailRead
AccountWorkers Builds ConfigurationEdit
AccountWorkers ObservabilityEdit
  1. If your workflows use bindings, add the corresponding permissions:
Binding typeAdditional permission needed
KV NamespaceAccount → Workers KV Storage → Edit
D1 DatabaseAccount → D1 → Edit
R2 BucketAccount → R2 Storage → Edit
QueuesAccount → Queues → Edit
AIAccount → Workers AI → Edit
  1. Under Account Resources, select the account you want AwaitStep to deploy to.
  2. Click Continue to summary, then Create Token.
  3. Copy the token — it is shown only once.

DANGER

Do not use your Global API Key. It grants unrestricted access to your entire Cloudflare account. Always use a scoped Custom token.

Connect in AwaitStep ​

  1. Go to Connections and click Add Connection.
  2. The dialog shows the exact permissions required. Paste your API token.
  3. Click Verify & Continue. AwaitStep validates the token and lists accessible accounts.
  4. Select the target account and confirm.

Add Connection dialog with required permissions

Token rotation ​

When you need to rotate the token (e.g. for security hygiene or after a suspected leak):

  1. Create a new token in the Cloudflare dashboard with the same permissions.
  2. In AwaitStep, go to Connections → Your Cloudflare Connection → Edit and paste the new token.
  3. Click Verify & Save.
  4. Delete the old token from the Cloudflare dashboard.

Existing deployed workflows are not affected by token rotation — they run as Cloudflare Workers and do not depend on the AwaitStep token at runtime.