---
title: "Create a face authentication"
method: POST
path: "/v2/face-authentications"
tags: ["Face authentications"]
---

# Create a face authentication

`POST /v2/face-authentications`

## Request

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

This endpoint allows you to create a face authentication.

## Request body

- FaceAuthenticationInputPost
  - `user_journey_id` string: User journey unique identifier.
  - `applicant_id` string: Applicant unique identifier.
  - `webhook_url` string, uri

## Response `201`

Face authentication created

- FaceAuthenticationOutputPost
  - `id` string: Face authentication unique identifier.
  - `status` 'created' | 'pending' | 'capture_in_progress' | 'checks_in_progress' | 'approved' | 'declined' | 'retry_required' | 'refused' | 'inconclusive': Status of the verification.
  - `response_codes` ResponseCodes[]
    - `code` integer, required: The numeric code of the response code.
    - `summary` string, required: A descriptive code of the response code.
  - `risk_labels` RiskLabel[]: Risk assessment labels
  - `face` VerificationFace
    - `image_signed_url` string, nullable
  - `_links` FaceAuthenticationLinks
    - `self` HalLink, required
      - `href` string, uri, required
    - `applicant` HalLink, required
      - `href` string, uri, required
  - `user_journey_id` string: User journey unique identifier.
  - `applicant_id` string: Applicant unique identifier.
  - `webhook_url` string, uri
  - `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

## Other responses

- `400`: Bad request
- `500`: Internal server error

---

[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)