---
title: "Changes to Create or update an event subscription."
method: PUT
path: "/{scope}/providers/Microsoft.EventGrid/eventSubscriptions/{eventSubscriptionName}"
---

# Changes to Create or update an event subscription.

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

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 24 revisions.

- **2026-07-13** (2017-06-15-preview) `285f714f3339` — 3 warning, 2 info
- **2026-07-13** (2017-06-15-preview) `6114a105ef69` — 1 warning, 2 info
- **2026-07-13** (2017-06-15-preview) `5bd940f4fdfb` — 1 info

## 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
  - api tag `EventSubscriptionOperationGroup` removed
- **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`

---

[Operation](https://skmtc.dev/azure/apis/eventgrid-microsoft-eventgrid-eventgrid/docs/:scope/providers/Microsoft.EventGrid/eventSubscriptions/:eventSubscriptionName/put.md) · [API](https://skmtc.dev/azure/apis/eventgrid-microsoft-eventgrid-eventgrid.md) · [Page](https://skmtc.dev/azure/apis/eventgrid-microsoft-eventgrid-eventgrid/changes/:scope/providers/Microsoft.EventGrid/eventSubscriptions/:eventSubscriptionName/put)