---
title: "PUT /users"
method: PUT
path: "/users"
tags: ["users"]
---

# PUT /users

`PUT /users`

Create a new user in a Heartbeat community

## Request body

- object
  - `email` string, email, required — The user's email. Must be unique to the community
  - `name` string, required — The user's full name
  - `roleID` string, uuid, required — The id of the role the user should have
  - `groupIDs` string[] — A list of the ids of the groups that the user should belong to
  - `profilePicture` string — A Data URI scheme in the JPG, GIF, or PNG format. Ensure you use the proper content type (image/jpeg, image/png, image/gif) that matches the image data being provided
  - `bio` string — The user's bio
  - `status` string — The user's status
  - `linkedin` string — A link to the user's LinkedIn profile
  - `twitter` string — A link to the user's Twitter profile
  - `instagram` string — A link to the user's Instagram profile
  - `createIntroductionThread` boolean — If true and a value for bio is provided, an introduction thread for the user will be created in the channel designated for introductions in your community settings. The introduction thread will include the user's bio

## Response `200`

Successful response

## Other responses

- `400` — Invalid request body
- `401` — API Key is missing or invalid

---

[API](https://skmtc.net/heartbeat/apis/heartbeat-api.md) · [All operations](https://skmtc.net/heartbeat/apis/heartbeat-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heartbeat/heartbeat-api/versions/6c3cf537d508/schema)