# Create a user profile

Creates a client profile in the embedded finance platform.

All fields are required.

Example request:
json
{
  "metaData": {
    "idempotencyKey": "partnerId_uuid",
    "partnerId": "partner-id",
    "partnerUserRef": "partner-user-id"
  },
  "payload": {
    "email": "ronald@gmail.com",
    "name": "Ronald",
    "entityType": "personal",
    "country": "ZAF",
    "firstName": "Ronald",
    "lastName": "Commander",
    "phoneNumber": "0652345678",
    "gender": "male",
    "dateOfBirth": "YYYY-MM-DD",
    "idNumber": "6979298760776",
    "idType": "National",
    "idIssueDate": "YYYY-MM-DD",
    "city": "Jozi",
    "residency": "Soweto",
    "title": "Ms",
    "officeId": 1
  }
}

Endpoint: POST /transactions/create-client
Version: 1.0.0

## Request fields (application/json):

  - `metaData` (object, required)
    Standard metadata supplied with each partner request.

  - `metaData.idempotencyKey` (string, required)
    Unique idempotency key for the request.
    Example: "partnerId_uuid"

  - `metaData.partnerId` (string, required)
    Partner identifier.
    Example: "partner-id"

  - `metaData.partnerUserRef` (string, required)
    Partner-side user reference.
    Example: "partner-user-id"

  - `payload` (object, required)
    Operation-specific payload.
    Example: {"accountId":"6c9083ce-b9d6-4415-8ad1-e32050fc8f93"}

## Response 200 fields (application/json):

  - `transactionData` (object, required)
    Summary information about a saga transaction.

  - `transactionData.transactionId` (integer, required)
    Internal transaction identifier.
    Example: 1

  - `transactionData.transactionType` (string, required)
    Type of transaction performed.
    Example: "TRANSFER"

  - `transactionData.transactionStatus` (string, required)
    Current transaction status.
    Example: "COMPLETED"

  - `transactionData.failedStep` (string,null)
    Name of the failed saga step when applicable.
    Example: "BANK_SUBMITTED"

  - `payload` (object, required)
    Operation-specific response payload.
    Example: {"cardId":"97c89895-372b-48ee-81c4-3230b4dbb6fd"}