---
title: "Add new end entity, if it does not exist"
method: POST
path: "/v1/endentity"
tags: ["v1/endentity"]
---

# Add new end entity, if it does not exist

`POST /v1/endentity`

Register new end entity based on provided registration data

## Request body

- AddEndEntityRestRequest
  - `username` string — Username
  - `password` string — Password
  - `subject_dn` string — Subject Distinguished Name
  - `subject_alt_name` string — Subject Alternative Name (SAN)
  - `email` string — Email
  - `extension_data` ExtendedInformationRestRequestComponent[]
    - `name` string — For extension_data a certificate extension object identifier (OID), for custom_data a string variable and value see ExtendedInformation class
    - `value` string — OID value
  - `custom_data` ExtendedInformationRestRequestComponent[]
    - `name` string — For extension_data a certificate extension object identifier (OID), for custom_data a string variable and value see ExtendedInformation class
    - `value` string — OID value
  - `ca_name` string — Certificate Authority (CA) name
  - `certificate_profile_name` string — Certificate profile name
  - `end_entity_profile_name` string — End Entity profile name
  - `token` 'USERGENERATED, P12, JKS, PEM' — Token type property
  - `account_binding_id` string — Account Binding ID
  - `key_recoverable` boolean — Key recoverable or not
  - `status` 'NEW, FAILED, INITIALIZED, INPROCESS, GENERATED, REVOKED, HISTORICAL, KEYRECOVERY, WAITINGFORADDAPPROVAL' — End entity status property
  - `send_notification` boolean — Send notification or not
  - `start_time` string — Valid start time
  - `end_time` string — Valid end time
  - `certificate_serial_number` integer — Certificate Serial Number
  - `card_number` string — Card Number

## Response `200`

Successful operation

## Changes

> 8 revisions in range; 1 could not be searched.

- **2025-03-11** `4045b1bab09f` — 4 breaking, 8 info
  - removed the enum value `JKS` of the request property `token`
  - removed the enum value `P12` of the request property `token`
  - removed the enum value `PEM` of the request property `token`
  - removed the enum value `USERGENERATED` of the request property `token`
  - …8 more
- **2025-03-11** `37878df36b77` — 2 breaking, 6 warning, 4 info
  - removed the enum value `USERGENERATED, P12, JKS, PEM` of the request property `token`
  - removed the success response with the status `200`
  - removed the request property `card_number`
  - removed the request property `certificate_serial_number`
  - …8 more
- **2025-01-24** `d0f3affe7c3c` — 4 breaking, 8 info
  - removed the enum value `JKS` of the request property `token`
  - removed the enum value `P12` of the request property `token`
  - removed the enum value `PEM` of the request property `token`
  - removed the enum value `USERGENERATED` of the request property `token`
  - …8 more
- **2024-07-05** `b6fc2ad168e5` — 2 breaking, 6 warning, 4 info
  - removed the enum value `USERGENERATED, P12, JKS, PEM` of the request property `token`
  - removed the success response with the status `200`
  - removed the request property `card_number`
  - removed the request property `certificate_serial_number`
  - …8 more

[Change history](https://skmtc.dev/keyfactor/apis/ejbca-rest-interface/changes/v1/endentity/post.md)

---

[API](https://skmtc.dev/keyfactor/apis/ejbca-rest-interface.md) · [All operations](https://skmtc.dev/keyfactor/apis/ejbca-rest-interface/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keyfactor/ejbca-rest-interface/revisions/44f8798658e2/schema)