---
title: Create Event Subscription
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[Queues](https://developers.cloudflare.com/api/resources/queues)
[Subscriptions](https://developers.cloudflare.com/api/resources/queues/subresources/subscriptions)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# Create Event Subscription
POST/accounts/{account\_id}/event\_subscriptions/subscriptions
Creates an event subscription for a Queue.
##### Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
**Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
**Example:**X-Auth-Email: user@example.com
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
**Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required)
`Queues Write``Workers Scripts Write`
##### P ath ParametersExpand Collapse
account\_id: string
A Resource identifier.
maxLength32
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>)
##### Body ParametersJSONExpand Collapse
destination: optional object {queue\_id, type }
Destination configuration for the subscription
queue\_id: string
ID of the target queue
Link to this property
type: "queues.queue"
Type of destination
Link to this property
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20destination%20%3E%20(schema)>)
enabled: optional boolean
Whether the subscription is active
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20enabled%20%3E%20(schema)>)
events: optional array of string
List of event types this subscription handles
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20events%20%3E%20(schema)>)
name: optional string
Name of the subscription
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20name%20%3E%20(schema)>)
source: optional object {type } or object {type } or object {type } or 6 more
Source configuration for the subscription
One of the following:
MqEventSourceImages object {type }
type: optional "images"
Type of source
Link to this property
Link to this property
MqEventSourceKV object {type }
type: optional "kv"
Type of source
Link to this property
Link to this property
MqEventSourceR2 object {type }
type: optional "r2"
Type of source
Link to this property
Link to this property
MqEventSourceSuperSlurper object {type }
type: optional "superSlurper"
Type of source
Link to this property
Link to this property
MqEventSourceVectorize object {type }
type: optional "vectorize"
Type of source
Link to this property
Link to this property
MqEventSourceWorkersAIModel object {model\_name, type }
model\_name: optional string
Name of the Workers AI model
Link to this property
type: optional "workersAi.model"
Type of source
Link to this property
Link to this property
MqEventSourceWorkersBuildsWorker object {type, worker\_name }
type: optional "workersBuilds.worker"
Type of source
Link to this property
worker\_name: optional string
Name of the worker
Link to this property
Link to this property
MqEventSourceWorkersScript object {script\_tag, type }
script\_tag: optional string
Tag of the Worker script
Link to this property
type: optional "workers.script"
Type of source
Link to this property
Link to this property
MqEventSourceWorkflowsWorkflow object {type, workflow\_name }
type: optional "workflows.workflow"
Type of source
Link to this property
workflow\_name: optional string
Name of the workflow
Link to this property
Link to this property
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(method)%20create%20%3E%20(params)%200%20%3E%20(param)%20source%20%3E%20(schema)>)
##### ReturnsExpand Collapse
errors: optional array of ResponseInfo { code, message, documentation\_url, source }
minLength1
code: number
minimum1000
Link to this property
message: string
Link to this property
documentation\_url: optional string
Link to this property
source: optional object {pointer }
pointer: optional string
Link to this property
Link to this property
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)
messages: optional array of string
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20messages>)
result: optional object {id, created\_at, destination, 5 more }
id: string
Unique identifier for the subscription
Link to this property
created\_at: string
When the subscription was created
formatdate-time
Link to this property
destination: object {queue\_id, type }
Destination configuration for the subscription
queue\_id: string
ID of the target queue
Link to this property
type: "queues.queue"
Type of destination
Link to this property
Link to this property
enabled: boolean
Whether the subscription is active
Link to this property
events: array of string
List of event types this subscription handles
Link to this property
modified\_at: string
When the subscription was last modified
formatdate-time
Link to this property
name: string
Name of the subscription
Link to this property
source: object {type } or object {type } or object {type } or 6 more
Source configuration for the subscription
One of the following:
MqEventSourceImages object {type }
type: optional "images"
Type of source
Link to this property
Link to this property
MqEventSourceKV object {type }
type: optional "kv"
Type of source
Link to this property
Link to this property
MqEventSourceR2 object {type }
type: optional "r2"
Type of source
Link to this property
Link to this property
MqEventSourceSuperSlurper object {type }
type: optional "superSlurper"
Type of source
Link to this property
Link to this property
MqEventSourceVectorize object {type }
type: optional "vectorize"
Type of source
Link to this property
Link to this property
MqEventSourceWorkersAIModel object {model\_name, type }
model\_name: optional string
Name of the Workers AI model
Link to this property
type: optional "workersAi.model"
Type of source
Link to this property
Link to this property
MqEventSourceWorkersBuildsWorker object {type, worker\_name }
type: optional "workersBuilds.worker"
Type of source
Link to this property
worker\_name: optional string
Name of the worker
Link to this property
Link to this property
MqEventSourceWorkersScript object {script\_tag, type }
script\_tag: optional string
Tag of the Worker script
Link to this property
type: optional "workers.script"
Type of source
Link to this property
Link to this property
MqEventSourceWorkflowsWorkflow object {type, workflow\_name }
type: optional "workflows.workflow"
Type of source
Link to this property
workflow\_name: optional string
Name of the workflow
Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
success: optional true
Indicates if the API call was successful or not.
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(method)%20create%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
### Create Event Subscription
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/event_subscriptions/subscriptions \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
-d '{}'
```
200 example
```
{
"errors": [
{
"code": 7003,
"message": "No route for the URI",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"messages": [
"string"
],
"result": {
"id": "id",
"created_at": "2019-12-27T18:11:19.117Z",
"destination": {
"queue_id": "queue_id",
"type": "queues.queue"
},
"enabled": true,
"events": [
"string"
],
"modified_at": "2019-12-27T18:11:19.117Z",
"name": "name",
"source": {
"type": "images"
}
},
"success": true
}
```
##### Returns Examples
200 example
```
{
"errors": [
{
"code": 7003,
"message": "No route for the URI",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"messages": [
"string"
],
"result": {
"id": "id",
"created_at": "2019-12-27T18:11:19.117Z",
"destination": {
"queue_id": "queue_id",
"type": "queues.queue"
},
"enabled": true,
"events": [
"string"
],
"modified_at": "2019-12-27T18:11:19.117Z",
"name": "name",
"source": {
"type": "images"
}
},
"success": true
}
```