Create persons for an account

​

Create a person

Path Parameters
  • account
    Type: string
    max length:  
    100
    required
Body·
required
application/json

Request to update a Person

  • Type: object
    • address
      Type: object ·

      The customer's address.

    • date_of_birth
      Type: object ·
    • email
      Type: string | null
      max length:  
      200

      The person's email address.

    • first_name
      Type: string | null
      max length:  
      200

      The person's first name.

    • last_name
      Type: string | null
      max length:  
      100

      The person's last name.

    • maiden_name
      Type: string | null
      max length:  
      100

      The person's maiden name.

    • metadata

      Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.

      Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.

      • propertyName
        Type: string
    • nationality
      Type: string | null
      max length:  
      100

      The country where the person is a national.

    • phone
      Type: string | null
      max length:  
      100

      The person's phone number.

    • political_exposure
      Type: string enum

      Indicates if the person or any of their representatives, family members, or other closely related persons, declares that they hold or have held an important public job or function, in any jurisdiction.

      values
      • existing
      • none
    • registered_address
      Type: object ·

      The customer's address.

    • relationship
      Type: object ·
    • documents
      Type: object ·

      Documents attached to this person.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/v1/accounts/{account}/persons
curl 'https://api.paypercut.io/v1/accounts/{account}/persons' \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "address": {
    "city": null,
    "country": null,
    "line1": null,
    "line2": null,
    "postal_code": null,
    "state": null
  },
  "date_of_birth": {
    "day": null,
    "month": null,
    "year": null
  },
  "email": null,
  "first_name": null,
  "last_name": null,
  "maiden_name": null,
  "metadata": {
    "additionalProperty": ""
  },
  "nationality": null,
  "phone": null,
  "political_exposure": "existing",
  "registered_address": {
    "city": null,
    "country": null,
    "line1": null,
    "line2": null,
    "postal_code": null,
    "state": null
  },
  "relationship": {
    "authorizer": null,
    "director": null,
    "executive": null,
    "legal_guardian": null,
    "owner": null,
    "percent_ownership": null,
    "representative": null,
    "title": null
  },
  "documents": {
    "identity_document": {
      "files": [
        ""
      ]
    },
    "proof_of_address": {
      "files": [
        ""
      ]
    }
  }
}'

{
  "id": "string",
  "created": "2026-07-28T08:24:41.303Z",
  "address": {
    "city": null,
    "country": null,
    "line1": null,
    "line2": null,
    "postal_code": null,
    "state": null
  },
  "date_of_birth": {
    "day": null,
    "month": null,
    "year": null
  },
  "email": null,
  "first_name": null,
  "last_name": null,
  "maiden_name": null,
  "metadata": {
    "additionalProperty": "string"
  },
  "nationality": null,
  "phone": null,
  "political_exposure": "none",
  "registered_address": {
    "city": null,
    "country": null,
    "line1": null,
    "line2": null,
    "postal_code": null,
    "state": null
  },
  "relationship": {
    "authorizer": null,
    "director": null,
    "executive": null,
    "legal_guardian": null,
    "owner": null,
    "percent_ownership": null,
    "representative": null,
    "title": null
  },
  "requirements": {
    "current_deadline": null,
    "currently_due": [
      "string"
    ],
    "disabled_reason": "action_required.requested_capabilities",
    "errors": [
      {
        "code": "external_request",
        "reason": "string",
        "requirement": "string"
      }
    ],
    "eventually_due": [
      "string"
    ],
    "past_due": [],
    "pending_verification": [
      "string"
    ]
  }
}

Person created successfully