Create Entity

POST

/api/v1/transformer/entity/create

This endpoint allows you to create a new entity with personal information, address details, and optional fields.

Request

Authorization

Add parameter in header

x-api-token

Example:

x-api-token: ********************

Body Params application/json

Examples

Responses

🟢201Created

application/json

Entity created successfully

Body

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/transformer/entity/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "individual",
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "phoneNumberPrefix": "1",
    "phoneNumber": "5551234567",
    "nationality": "US",
    "dateOfBirth": "1990-01-01",
    "permanentAddress": {
        "addressLine1": "123 Main St",
        "addressLine2": "Apt 4B",
        "locality": "Downtown",
        "city": "San Francisco",
        "state": "CA",
        "country": "US",
        "postalCode": "94103"
    }
}'

Response Example

201 - Example 1

{
    "success": true,
    "data": {
        "message": "Entity created successfully",
        "entityId": "entity_60d21b4fb216eb3d4893d98a"
    }
}

Modified at 2025-11-11 15:50:56

Entities