---
title: "Subscribe a single user profile to a list"
method: PUT
path: "/lists/{list_id}/subscriptions/{user_id}"
tags: ["Lists"]
---

# Subscribe a single user profile to a list

`PUT /lists/{list_id}/subscriptions/{user_id}`

Subscribes one user to a list, creating the list if it does not yet exist. Optional preferences apply to this subscription only.

## Path parameters

- `list_id` string, required
- `user_id` string, required

## Request body

- object
  - `preferences` RecipientPreferences
    - `categories` NotificationPreferences
    - `notifications` NotificationPreferences

## Response `204`

---

[API](https://skmtc.dev/trycourier/apis/courier.md) · [All operations](https://skmtc.dev/trycourier/apis/courier/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trycourier/courier/revisions/cb8586034158/schema)