---
title: "Changes to Add subscribers to a list"
method: POST
path: "/lists/{list_id}/subscriptions"
---

# Changes to Add subscribers to a list

`POST /lists/{list_id}/subscriptions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 55 revisions.

- **2026-07-29** `f76bed79a913` — 2 info
- **2026-01-05** `361d17797dff` — 1 info
- **2025-12-08** `59c9efb45644` — 1 breaking
- **2025-12-02** `b232056686e3` — 1 info

## Changes

- **2026-07-29** `f76bed79a913` — 2 info
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new optional `header` request parameter `x-idempotency-expiration`
- **2026-01-05** `361d17797dff` — 1 info
  - added the success response with the status `202`
- **2025-12-08** `59c9efb45644` — 1 breaking
  - removed the success response with the status `202`
- **2025-12-02** `b232056686e3` — 1 info
  - added the success response with the status `202`

---

[Operation](https://skmtc.dev/trycourier/apis/courier/docs/lists/:list_id/subscriptions/post.md) · [API](https://skmtc.dev/trycourier/apis/courier.md) · [Page](https://skmtc.dev/trycourier/apis/courier/changes/lists/:list_id/subscriptions/post)