Skip to main content
POST
/
customers
/
{id}
/
control-persons
Create control persons
curl --request POST \
  --url https://api.conduit.financial/customers/{id}/control-persons \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-API-Secret: <api-key>' \
  --data '{
  "controlPersons": [
    {
      "firstName": "John",
      "lastName": "Doe",
      "middleName": "Michael",
      "email": "john.doe@example.com",
      "address": {
        "streetLine1": "123 Main St",
        "streetLine2": "Suite 100",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA"
      },
      "nationality": "USA",
      "sharesAllocated": 500,
      "ownershipPercentage": 35.5,
      "birthDate": "2000-01-01T00:00:00.000Z",
      "gender": "male",
      "phone": "+1234567890",
      "title": "CEO",
      "isEntity": false,
      "ssn": "123-45-6789",
      "immigrationStatus": "citizen",
      "numberType": "ssn",
      "taxResidencyCountry": "USA",
      "regulatoryAffiliations": [
        {
          "regulatoryAffiliation": "FINRA"
        }
      ],
      "roles": [
        {
          "name": "beneficial_owner",
          "startDate": "2021-01-01T00:00:00.000Z",
          "endDate": "2025-01-01T00:00:00.000Z",
          "current": true
        }
      ],
      "identityInfo": {
        "documentCountry": "USA",
        "documentType": "passport",
        "documentNumber": "1234567890",
        "documentIssueDate": "2021-01-01T00:00:00.000Z",
        "documentExpiryDate": "2025-01-01T00:00:00.000Z"
      }
    },
    {
      "firstName": "Marie",
      "lastName": "Dubois",
      "middleName": "Claire",
      "email": "marie.dubois@example.com",
      "address": {
        "streetLine1": "15 Rue de la Paix",
        "streetLine2": "Apt 4B",
        "city": "Paris",
        "state": "Île-de-France",
        "postalCode": "75001",
        "country": "FRA"
      },
      "nationality": "FRA",
      "sharesAllocated": 750,
      "ownershipPercentage": 64.25,
      "birthDate": "1988-03-15T00:00:00.000Z",
      "gender": "female",
      "phone": "+33123456789",
      "title": "CTO",
      "isEntity": false,
      "taxResidencyCountry": "FRA",
      "regulatoryAffiliations": [
        {
          "regulatoryAffiliation": "ACPR"
        }
      ],
      "roles": [
        {
          "name": "beneficial_owner",
          "startDate": "2020-01-01T00:00:00.000Z",
          "endDate": "2030-01-01T00:00:00.000Z",
          "current": true
        }
      ],
      "identityInfo": {
        "documentCountry": "FRA",
        "documentType": "passport",
        "documentNumber": "FR123456789",
        "documentIssueDate": "2020-01-01T00:00:00.000Z",
        "documentExpiryDate": "2030-01-01T00:00:00.000Z"
      }
    }
  ]
}'
{
  "success": true,
  "customerId": "cus_2ofTA13AD0xBtbEvBl20aEb1hEu",
  "controlPersons": [
    {
      "id": "ctl_2ofTA13AD0xBtbEvBl20aEb1hEu",
      "firstName": "John",
      "lastName": "Doe",
      "middleName": "Michael",
      "email": "john.doe@example.com",
      "birthDate": "2000-01-01T00:00:00.000Z",
      "address": {
        "streetLine1": "123 Main St",
        "streetLine2": "Suite 100",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "USA"
      },
      "nationality": "USA",
      "gender": "male",
      "phone": "+1234567890",
      "title": "CEO",
      "isEntity": false,
      "immigrationStatus": "citizen",
      "numberType": "ssn",
      "taxResidencyCountry": "USA",
      "regulatoryAffiliations": [
        {
          "regulatoryAffiliation": "FINRA"
        }
      ],
      "sharesAllocated": 1500,
      "ownershipPercentage": 100,
      "referenceId": "ref_123",
      "roles": [
        {
          "name": "beneficial_owner",
          "startDate": "2021-01-01T00:00:00.000Z",
          "endDate": "2025-01-01T00:00:00.000Z",
          "current": true
        }
      ],
      "identityInfo": {
        "documentCountry": "USA",
        "documentType": "passport",
        "documentNumber": "1234567890",
        "documentIssueDate": "2021-01-01T00:00:00.000Z",
        "documentExpiryDate": "2025-01-01T00:00:00.000Z"
      }
    }
  ]
}

Authorizations

X-API-Key
string
header
required

Includes an API key in the HTTP headers to authenticate the client.

X-API-Secret
string
header
required

Includes an API secret in the HTTP headers to authenticate the client.

Path Parameters

id
string
required

A valid Customer ID

Example:

"cus_2ofTA13AD0xBtbEvBl20aEb1hEu"

Body

application/json

Request to create a control person

controlPersons
object[]
required
Minimum length: 1

Response

Control persons created

Control person creation response

success
boolean
required
controlPersons
object[]
required
customerId
string

A valid Customer ID

Example:

"cus_2ofTA13AD0xBtbEvBl20aEb1hEu"

I