---
title: "Create Corporate Account with Legal Representative"
method: POST
path: "/accounts/legal-entity"
tags: ["accounts"]
---

# Create Corporate Account with Legal Representative

`POST /accounts/legal-entity`

## Request

- Base URL: `https://onboarding-api.lemonway.com`
- URL: `https://onboarding-api.lemonway.com/accounts/legal-entity`
- Auth: HTTP bearer

Creates a new legal entity account by providing the entity’s details along with information about its legal representative. This request is typically the first step before initiating the onboarding process. Once created, the account will have an initial status (e.g., CREATED) and a profile status (e.g., AWAITING_INFORMATION)

## Request body

- CreateLegalEntityAccountRequest
  - `activity` 'CROWDFUNDING_MONEYPOT' | 'CROWDFUNDING_DONATION' | 'MARKETPLACE_B2B' | 'MARKETPLACE_B2C' | 'MARKETPLACE_C2C' | 'CROWDEQUITY' | 'CROWDLENDING' | 'VALUE_ADDED_SERVICE' | 'INVOICE_TRADING' | 'MARKETPLACE_B2C_C2C' | 'VISA_ACCOUNT_APPLICATION' | 'SALARY_ADVANCE': Activity code or category for the legal entity (e.g., type of business)
  - `legalEntity` LegalEntity, required: Details about the legal entity (see nested bodyParams)
    - `name` string, required: Full legal name of the entity.
    - `type` 'COMPANY' | 'ASSOCIATION' | 'SOLE_TRADER', required: Legal form/type of the entity.
    - `registrationNumber` string: Official company registration number
    - `registrationDate` string, date-time, required: Date of legal registration (ISO 8601 format)
    - `address` Address
      - `country` string, required: Country of residence (ISO 2-letter code)
  - `legalRepresentative` LegalRepresentative, required: Information about the entity’s legal representative (see nested bodyParams).
    - `firstName` string, required: Representative’s first name
    - `lastName` string, required: Representative’s last name
    - `birthDate` string, date-time, required: Date of birth (ISO 8601 format)
    - `birthCountry` string, required: Country of birth (ISO 2-letter code)
    - `nationalities` string[], required: List of nationality codes (ISO 2-letter)
    - `email` string, required: Email address of the legal representative
    - `address` Address, required
      - `country` string, required: Country of residence (ISO 2-letter code)
  - `profile` 'DONOR' | 'PROJECT_HOLDER' | 'LENDER' | 'INVESTOR' | 'CREDITOR' | 'DEBTOR' | 'BUYER' | 'MERCHANT' | 'SELLER' | 'OPERATOR' | 'CONTENT_EDITOR' | 'OTHER_OPERATOR' | 'VISA_APPLICANT' | 'PAYER', required: User profile type
  - `walletId` string: Wallet identifier

## Response `201`

Account created successfully

- CreateAccountResponse
  - `id` string, required
  - `status` 'ACCEPTED' | 'CREATED' | 'DENIED' | 'BLOCKED', required
  - `profileStatus` 'ACCEPTED' | 'AWAITING_INFORMATION' | 'CREATION_IN_PROGRESS' | 'DENIED' | 'IDENTITY_VERIFICATION_IN_PROGRESS' | 'IDENTITY_VERIFICATION_ABANDONED' | 'IDENTITY_VERIFICATION_ERROR' | 'INFORMATION_COLLECTION_IN_PROGRESS' | 'REJECTED' | 'UNDER_ANALYSIS', required

## Other responses

- `400`: Missing or invalid request parameters
- `401`: Missing or invalid authentication token
- `409`: Account with similar details already exists
- `500`: Unexpected error occurred on the server

## Changes

- **2026-11-03** `cd81a3b18d83`: 2 breaking, 6 warning, 2 info
  - the request property `legalEntity/address/country` became required
  - the request property `legalRepresentative/address/country` became required
  - removed the request property `legalEntity/address/city`
  - removed the request property `legalEntity/address/postCode`
  - …6 more

[Operation history](https://skmtc.dev/lemonway/apis/account-onboarding-management-api/changes/accounts/legal-entity/post.md)

---

[API](https://skmtc.dev/lemonway/apis/account-onboarding-management-api.md) - [All operations](https://skmtc.dev/lemonway/apis/account-onboarding-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lemonway/apis/account-onboarding-management-api/revisions/cd81a3b18d83?raw)