Create a member account

POST

/account/create

const url = 'https://acme.mykreezalid.com/front_api/v1/account/create';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"email":"jane@example.com","password":"example","first_name":"Jane","last_name":"Doe","display_name":"example","username":"example","business_name":"example","account_type":"individual","group_id":12,"external_id":"example","lang":"fr","currency":"EUR","timezone":"Europe/Paris","birthday":"1990-04-12","nationality":"FR","description":"example","phone_country_code":"33","phone_number":"612345678","address_line1":"example","address_line2":"example","address_city":"example","address_zipcode":"example","address_state":"example","address_country":"FR","company_number":"example","company_website_url":"example","company_address_line1":"example","company_address_line2":"example","company_postal_code":"example","company_city":"example","company_state":"example","company_country":"example","ssn_last_4":"example","meta_title":"example","meta_description":"example","meta_keywords":"example","attributes":{}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://acme.mykreezalid.com/front_api/v1/account/create \
  --header 'Content-Type: application/json' \
  --data '{ "email": "jane@example.com", "password": "example", "first_name": "Jane", "last_name": "Doe", "display_name": "example", "username": "example", "business_name": "example", "account_type": "individual", "group_id": 12, "external_id": "example", "lang": "fr", "currency": "EUR", "timezone": "Europe/Paris", "birthday": "1990-04-12", "nationality": "FR", "description": "example", "phone_country_code": "33", "phone_number": "612345678", "address_line1": "example", "address_line2": "example", "address_city": "example", "address_zipcode": "example", "address_state": "example", "address_country": "FR", "company_number": "example", "company_website_url": "example", "company_address_line1": "example", "company_address_line2": "example", "company_postal_code": "example", "company_city": "example", "company_state": "example", "company_country": "example", "ssn_last_4": "example", "meta_title": "example", "meta_description": "example", "meta_keywords": "example", "attributes": {} }'

Registers a new member with an email address and a password, then sends a welcome email. When the marketplace requires email confirmation, the account stays inactive (and cannot sign in) until the member opens the confirmation link sent by email. Accounts registered with an email domain the marketplace refuses are created blocked. Send group_id to choose the member group; without account_type, it is derived from the group (individual by default). Sign in afterwards with POST /auth/login: this endpoint does not return a token. It only works for a visitor who is not signed in: a request that already carries a valid token or session is refused with 403.

Parameters

Query Parameters

no-confirmation-email

string

When present (whatever its value), no welcome or confirmation email is sent.

Request Body^required

application/json

object

email

required

string format: email

Example

jane@example.com

password

required

string format: password

first_name

string

Example

Jane

last_name

string

Example

Doe

display_name

string

username

string

business_name

string

account_type

string

Allowed values: individual company soletrader non_profit

group_id

Member group (type of account) to join.

integer

Example

external_id

Identifier of the member in your own system.

string

lang

string

Example

fr

currency

string

Example

EUR

timezone

string

Example

Europe/Paris

birthday

string format: date

Example

1990-04-12

nationality

Country code.

string

Example

FR

description

Presentation shown on the member’s profile.

string

phone_country_code

string

Example

phone_number

string

Example

612345678

address_line1

string

address_line2

string

address_city

string

address_zipcode

string

address_state

string

address_country

Country code.

string

Example

FR

company_number

Company registration number.

string

company_website_url

string

company_address_line1

string

company_address_line2

string

company_postal_code

string

company_city

string

company_state

string

company_country

string

ssn_last_4

Last four digits of the member’s social security number.

string

meta_title

Search-engine title of the member’s profile page.

string

meta_description

Search-engine description of the member’s profile page.

string

meta_keywords

string

attributes

Values of the custom member fields defined by the marketplace, keyed by field alias.

object

key

additional properties

any

Responses

201

The account is created.

application/json

object

code

integer

success

boolean

user

A member of the marketplace (a buyer, a vendor, or both). Returned for the signed-in member by GET /auth/me and POST /account/create, and as the customer or the vendor of a review or an order.

object

object

A member of the marketplace, as the Front API returns it.

string

Unique identifier of the member.

integer

external_id

Identifier of the member in your own system, if you set one.

string

nullable

account_type

Legal form of the member.

string

nullable

Allowed values: individual company soletrader non_profit

first_name

string

nullable

last_name

string

nullable

username

string

nullable

public_name

Name shown to other members, built from the member’s details according to the marketplace’s display settings.

string

business_name

string

nullable

email

string format: email

avatar

URL of the member’s profile picture.

string format: uri

nullable

birthday

string format: date

nullable

nationality

Country code.

string

nullable

lang

Preferred language of the member.

string

nullable

locale

Same value as lang.

string

nullable

timezone

string

nullable

phone_country_code

string

nullable

phone_number

string

nullable

address_line1

string

nullable

address_line2

string

nullable

address_city

string

nullable

address_zipcode

string

nullable

address_state

string

nullable

address_country

Country code.

string

nullable

company

Company details. Absent when account_type is individual.

object

object

string

name

Same value as the member’s business_name.

string

nullable

number

Company registration number.

string

nullable

website_url

string

nullable

address_line1

string

nullable

address_line2

string

nullable

address_city

string

nullable

address_zipcode

string

nullable

address_state

string

nullable

address_country

string

nullable

group

The member group (type of account) the member belongs to.

object

object

string

integer

nullable

name

Name of the group.

string

nullable

alias

Handle of the group.

string

nullable

group_id

Use group.id.

integer

nullable

group_name

Use group.name.

string

nullable

group_alias

Use group.alias.

string

nullable

can_post_listing

Whether the member’s group may publish listings.

boolean

is_onboarding

Whether the member’s group is an onboarding group.

boolean

status

Whether the account is active.

string

Allowed values: enabled disabled unknown

identity_status

Progress of the member’s identity verification. Read-only: the member cannot change it.

string

nullable

Allowed values: not_completed completed

attributes

Values of the custom member fields defined by the marketplace, keyed by field alias. A value is a string, or a list for multiple-choice fields.

object

key

additional properties

any

metafields

Custom data attached to the member, grouped by namespace then keyed by title: {"namespace": {"title": "value"}}. null when the member has none.

object

key

additional properties

object

key

additional properties

any

listing_count

Number of the member’s listings online.

integer

nullable

listing_count_any_status

Number of the member’s listings, whatever their status.

integer

average_rating

Average rating received in reviews.

number

nullable

review_count

Number of reviews received.

integer

nullable

profile_url

Public profile page of the member on the marketplace.

string format: uri

created_at

Registration date, as YYYY-MM-DD HH:MM:SS.

string

nullable

Example

{
  "code": 201,
  "success": true,
  "user": {
    "object": "User",
    "id": 4242,
    "account_type": "individual",
    "first_name": "Jane",
    "last_name": "Doe",
    "public_name": "Jane D.",
    "email": "jane@example.com",
    "birthday": "1990-04-12",
    "nationality": "FR",
    "lang": "fr",
    "locale": "fr",
    "timezone": "Europe/Paris",
    "phone_country_code": "33",
    "phone_number": "612345678",
    "address_line1": "12 rue de la Paix",
    "address_city": "Paris",
    "address_zipcode": "75002",
    "address_country": "FR",
    "company": {
      "object": "Company"
    },
    "group": {
      "object": "Group",
      "id": 12,
      "name": "Vendors",
      "alias": "vendors"
    },
    "status": "enabled",
    "identity_status": "not_completed",
    "attributes": {
      "profession": "Photographer"
    },
    "average_rating": 4.5,
    "profile_url": "https://acme.mykreezalid.com/s/a1b2c3d/jane-d",
    "created_at": "2026-10-01 09:30:00"
  }
}

400

Email is required, Password is required, Email already used, or Group with ID <id> does not exist.

application/json

Error body returned by the Front API when it refuses a request.

object

code

HTTP status code, repeated in the body.

integer

status

string

message

Human-readable reason.

string

Example

{
  "code": 403,
  "status": "error",
  "message": "Token not found in request"
}

403

The request already identifies a signed-in member.

Create a member account

Parameters

Query Parameters

Request Bodyrequired

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Example

Responses

201

Example

400

Example

403

Request Body^required