---
title: "Create user"
method: POST
path: "/users"
tags: ["Users"]
---

# Create user

`POST /users`

Create a new user.

**gigstack Connect:** Create users for other teams using the `team` parameter.

## Query parameters

- `team` string

## Request body

- UserInput
  - `email` string, email, nullable
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `phone` string, nullable
  - `company_role` string, nullable
  - `address` object, nullable — User address information. Note: municipality field is accepted in requests but not returned in responses.
    - `country` string, nullable
    - `street` string, nullable
    - `zip` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `exterior` string, nullable
    - `municipality` string, nullable — Municipality name (accepted in requests, stored in database, but not returned in responses)
    - `neighborhood` string, nullable
  - `auto_join` boolean, nullable — If true, automatically adds the user to the team associated with the API key. Defaults to false if not specified. When true and role is specified, the user will be added with that role.
  - `role` 'editor' | 'admin' | 'viewer', nullable — Role to assign to the user when auto_join is true. Can be "editor", "admin", or "viewer". Defaults to "viewer" if not specified. This parameter works in conjunction with auto_join - when auto_join is true, the user will be added to the team with the specified role.

## Response `200`

User created successfully

- StandardSuccessResponse
  - `message` string, required
  - `data` object, required

---

[API](https://skmtc.net/disruptive-learning/apis/gigstack-api-v2.md) · [All operations](https://skmtc.net/disruptive-learning/apis/gigstack-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/disruptive-learning/gigstack-api-v2/versions/5cf53ffd7580/schema)