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

# Create or update user

`POST /users/upsert`

Endpoint to create or update a user.

## Request body

- object — Update properties of a user
  - `identification` object, required — User identification requires a userId, email or both
    - `email` string, email — Email address of the user
    - `userId` string, user-id — Unique identifier for the user in your database
  - `properties` object — The properties being set, possible values are strings, booleans, numbers and datetimes (ISO 8601)

## Response `201`

User will be created

- object — Specifies if any warnings occurred when validating the properties
  - `meta` object, required
    - `requestId` string, required
    - `status` number, required
  - `message` string, required
  - `rejected` object — If validation fails, specifies property name and error description

## Other responses

- `400` — Bad request, some fields or parameters are incorrect
- `401` — No API Key was provided or the key is not authorised to perform the action
- `403` — The API Key provided is currently not enabled
- `429` — Too many API requests were send
- `500` — An unexpected error occurred

---

[API](https://skmtc.dev/journy/apis/developer-documentation.md) · [All operations](https://skmtc.dev/journy/apis/developer-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/journy/developer-documentation/revisions/2abe45a5c780/schema)