---
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`

---

[API](https://skmtc.net/trycourier/apis/courier.md) · [All operations](https://skmtc.net/trycourier/apis/courier/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trycourier/courier/versions/04f69fbf96a5/schema)