---
title: "Add a User to Multiple Tenants"
method: PUT
path: "/users/{user_id}/tenants"
tags: ["Tenant Memberships"]
---

# Add a User to Multiple Tenants

`PUT /users/{user_id}/tenants`

Adds a user to several tenants in one call, each optionally with a per-tenant profile that overrides their workspace profile.

## Path parameters

- `user_id` string, required

## Request body

- object
  - `tenants` UserTenantAssociation[], required
    - `user_id` string, nullable — User ID for the association between tenant and user
    - `type` 'user', nullable
    - `tenant_id` string, required — Tenant ID for the association between tenant and user
    - `profile` object, nullable — Additional metadata to be applied to a user profile when used in a tenant context

## Response `204`

## Changes

- **2026-07-29** `f76bed79a913` — 2 info
  - api tag `Tenant Memberships` added
  - api tag `User Tenants` removed
- **2026-01-12** `b79e0eb1ab06` — 1 info
  - api operation id `users_tenants_addMultple` removed and replaced with `users_tenants_addMultiple`
- **2025-10-15** `e67d02739533` — 2 info
  - api tag `User Tenants` added
  - api tag `UsersTenants` removed

[Change history](https://skmtc.dev/trycourier/apis/courier/changes/users/:user_id/tenants/put.md)

---

[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)