---
title: "Register a user"
method: POST
path: "/blaize/register"
tags: ["User"]
---

# Register a user

`POST /blaize/register`

## Request

- Base URL: `https://demo-site`
- URL: `https://demo-site/blaize/register`
- Auth: one of:
  - API key in cookie `blaize_session`
  - API key in query parameter `jwt`
  - API key in header `x-blaize-jwt`
  - API key in header `x-zephr-jwt`
  - HTTP bearer
  - API key in cookie `blaize_jwt`

This endpoint enables clients to initiate the creation of a new user account. If a contact with an identical  email address already exists, that contact will be elevated to the status of a registered user.  Essential attributes like `identifiers.email_address` and `validators.password` are mandatory for this endpoint.  If any of these attributes are absent, registration attempts will trigger an error.  Upon a successful request, session cookies like blaize_session and blaize_tracking_id are generated and  included in the response header.

## Request body

- UserRegisterRequest
  - `identifiers` Identifiers, required
    - `email_address` string
  - `validators` Validators, required
    - `password` string
    - `use_sso` boolean: When this is present there should be no identifiers in the body. The user is identified through a blaize_session cookie.
  - `attributes` Attributes

## Response `200`

OK. The user was registered successfully.

- UserRegisterResponse
  - `cookie` string
  - `message` string
  - `tracking_id` string

## Other responses

- `400`: Bad Request. The request included invalid syntax or was missing required parameters. This could alternatively be attributed to the absence of a user email address in the request body.

---

[API](https://skmtc.dev/zuora/apis/zuora-2.md) - [All operations](https://skmtc.dev/zuora/apis/zuora-2/llms.txt) - [OpenAPI document](https://skmtc.dev/zuora/apis/zuora-2/revisions/678190d04c40?raw)