---
title: "Create or update account"
method: POST
path: "/accounts/upsert"
tags: ["Accounts"]
---

# Create or update account

`POST /accounts/upsert`

Endpoint used to create or update an account.

## Request body

- object — Update properties and/or members of an account
  - `identification` object, required — Account identification requires an accountId, domain or both
    - `domain` string, top-level-domain — The domain associated with the account (e.g. acme-inc.com)
    - `accountId` string, account-id — Unique identifier for the account in your database
  - `properties` object — The properties being set, possible values are strings, booleans, numbers and datetimes (ISO 8601)

## Response `201`

Account 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 the property name and error message

## 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)