---
title: "Create an Applicant"
method: POST
path: "/v2/applicants"
tags: ["Applicants"]
---

# Create an Applicant

`POST /v2/applicants`

## Request

- Base URL: `https://api.ubble.ai`
- URL: `https://api.ubble.ai/v2/applicants`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ubble/apis/checkout-com-identity-verification/docs/v2/applicants/post.ts> (a function with typed inputs; its response is checked against the schema)

This section describes all endpoints related to applicants. It will enable you to create and manage applicant objects.

## Request body

- ApplicantInputPost
  - `external_applicant_id` string
  - `external_applicant_name` string
  - `email` string, email

## Response `201`

Applicant successfully created

- ApplicantOutputPost
  - `id` string: Applicant unique identifier.
  - `created_on` string, date-time, required: UTC Date time when the resource was created
  - `modified_on` string, date-time, required: UTC Date time when the resource was modified
  - `external_applicant_id` string
  - `external_applicant_name` string
  - `email` string, email
  - `_links` SelfLink, required
    - `self` HalLink, required
      - `href` string, uri, required

## Other responses

- `400`: Bad request

---

[API](https://skmtc.dev/ubble/apis/checkout-com-identity-verification.md) - [All operations](https://skmtc.dev/ubble/apis/checkout-com-identity-verification/llms.txt) - [OpenAPI document](https://skmtc.dev/ubble/apis/checkout-com-identity-verification/revisions/739e9da12584?raw)
