Manage event subscriptions

Last updated Apr 21, 2026 Learn how to:

  • Create event subscriptions to receive messages from Cloudflare services.
  • View existing subscriptions on your queues.
  • Delete subscriptions you no longer need.

Create subscription

Creating a subscription allows your queue to receive messages when events occur in Cloudflare services. You can specify which source and events you want to subscribe to.

Dashboard

  1. In the Cloudflare dashboard, go to the Queues page. Go to Queues ↗
  2. Select the queue you want to add a subscription to.
  3. Switch to the Subscriptions tab.
  4. Select Subscribe to events.
  5. Name your subscription, and select the desired source and events.
  6. Select Subscribe.

Wrangler CLI

To create a subscription using Wrangler, run the queues subscription create command:

npx wrangler queues subscription create <queue-name> --source <source-type> --events <event1,event2> --<source-specific-option> <value>

To learn more about which sources and events you can subscribe to, refer to Events & schemas.

View existing subscriptions

You can view all subscriptions configured for a queue to see what events it is currently receiving.

Dashboard

  1. In the Cloudflare dashboard, go to the Queues page. Go to Queues ↗
  2. Select the queue you want to view subscriptions for.
  3. Switch to the Subscriptions tab.

Wrangler CLI

To list subscriptions for a queue, run the queues subscription list command:

npx wrangler queues subscription list <queue-name>

Delete subscription

When you delete a subscription, your queue will stop receiving messages for those events immediately.

Dashboard

  1. In the Cloudflare dashboard, go to the Queues page. Go to Queues ↗
  2. Select the queue containing the subscription you want to delete.
  3. Switch to the Subscriptions tab.
  4. Select ... for the subscription you want to delete.
  5. Select Delete subscription.

Wrangler CLI

To delete a subscription, run the queues subscription delete command:

npx wrangler queues subscription delete <queue-name> --id <subscription-id>

Learn more

Events & schemas

Explore available event sources and types that you can subscribe to.

Was this helpful?

YesNo

On this page

Manage event subscriptions - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/queues/event-subscriptions/manage-event-subscriptions/#page","headline":"Manage event subscriptions","description":"Learn how to create, view, and delete event subscriptions for your queues.","url":"https://developers.cloudflare.com/queues/event-subscriptions/manage-event-subscriptions/","inLanguage":"en","image":"https://developers.cloudflare.com/queues/event-subscriptions/manage-event-subscriptions/og.png?v=05e1d89ca9e9ad42","dateModified":"2026-04-21","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Query Cloudflare Queues backlog, concurrency, and message operation metrics via GraphQL. title: Metrics image: https://developers.cloudflare.com/queues/observability/metrics/og.png?v=8726244059d387fc

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/queues/llms.txt
Use this file to discover all available pages before exploring further.