---
title: "Add a cluster member"
method: POST
path: "/clusters/{clusterId}/members"
tags: ["Clusters"]
---

# Add a cluster member

`POST /clusters/{clusterId}/members`

User must have the CLUSTER_MEMBER[CREATE] permission.

## Request body

- AddMember — Membership can be created for existing users, or for users provided by external identity provider. Thus, either userId or externalReference are required.
  - `userId` string — Technical identifier for existing user.
  - `externalReference` string — User's reference for user provided from an identity provider.
  - `roleName` string, required — The name of the role

## Response `201`

Member successfully added

## Other responses

- `default` — Generic error response

---

[API](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-environments.md) · [All operations](https://skmtc.net/gravitee-io/apis/gravitee-io-apim-management-api-environments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gravitee-io/gravitee-io-apim-management-api-environments/versions/a2bffc8c2e17/schema)