---
title: "Create or update an event subscription."
method: PUT
path: "/{scope}/providers/Microsoft.EventGrid/eventSubscriptions/{eventSubscriptionName}"
tags: ["EventSubscriptions"]
---

# Create or update an event subscription.

`PUT /{scope}/providers/Microsoft.EventGrid/eventSubscriptions/{eventSubscriptionName}`

Asynchronously creates a new event subscription or updates an existing event subscription based on the specified scope.

## Path parameters

- `eventSubscriptionName` string, required

## Parameters

- `../../../../../../common-types/resource-management/v6/types.json#/components/parameters/ScopeParameter` — unresolved $ref
- `../../../../../../common-types/resource-management/v6/types.json#/components/parameters/ApiVersionParameter` — unresolved $ref

## Request body

- EventSubscription — Definition of a Resource.
  - `id` string — Fully qualified identifier of the resource.
  - `name` string — Name of the resource.
  - `type` string — Type of the resource.

## Response `201`

EventSubscription CreateOrUpdate request accepted.

- EventSubscription — Definition of a Resource.
  - `id` string — Fully qualified identifier of the resource.
  - `name` string — Name of the resource.
  - `type` string — Type of the resource.

## Other responses

- `default` — *** Error Responses: *** * 400 Bad Request. * 500 Internal Server Error.

## Changes

- **2026-07-13** (2017-06-15-preview) `285f714f3339` — 3 warning, 2 info
  - the optional response header `Location` removed for the status `201`
  - the optional response header `Retry-After` removed for the status `201`
  - deleted the `path` request parameter `scope`
  - api tag `EventSubscriptions` added
  - …1 more
- **2026-07-13** (2017-06-15-preview) `6114a105ef69` — 1 warning, 2 info
  - deleted the `query` request parameter `api-version`
  - api tag `EventSubscriptionOperationGroup` added
  - api tag `EventSubscriptions` removed
- **2026-07-13** (2017-06-15-preview) `5bd940f4fdfb` — 1 info
  - api operation id `EventSubscriptions_Create` removed and replaced with `EventSubscriptions_CreateOrUpdate`

[Change history](https://skmtc.dev/azure/apis/eventgrid-microsoft-eventgrid-eventgrid/changes/:scope/providers/Microsoft.EventGrid/eventSubscriptions/:eventSubscriptionName/put.md)

---

[API](https://skmtc.dev/azure/apis/eventgrid-microsoft-eventgrid-eventgrid.md) · [All operations](https://skmtc.dev/azure/apis/eventgrid-microsoft-eventgrid-eventgrid/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/eventgrid-microsoft-eventgrid-eventgrid/revisions/285f714f3339/schema)