Create Individual

Add a new individual/officer on a corporate customer

SecurityOAuth2: OAuth2Flow

Request

path Parameters

required

string

Corporate Customer ID. This operation can only be performed on corporate customers.

header Parameters

Authorization	string OAuth bearer token (see authentication flows)
x-l2f-request-id	string Optional Unique ID per request, useful for fault resolution/diagnosis and audit.
x-l2f-idempotency-id	string Unique ID used to safely retry an operation. See idempotency section for more details.

Request Body schema: application/json

individual_type required	Array of strings Type of Individual (use individual for non corporate customers) Items Enum: "INDIVIDUAL" "OFFICER" "BENEFICIAL_OWNER" "CONTROL_PERSON" "AUTHORIZED_PERSON"
first_name required	string First name
middle_name	string Middle Name(s) (if present)
last_name required	string Last name
email_address	string Email Address
	object (mailing_address) Mailing Address
telephone_number	string Telephone Number in E.164 format
tax_reference_number	string Tax reference number of the country (SSN, ITIN, SIN, National Insurance Number etc)
passport_number	string Passport Number
nationality	string Nationality (2 Digit ISO31661-Alpha2 Format - https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
date_of_birth	string <date> RFC3339 (YYYY-MM-DD) Date of Birth
percentage_ownership	integer <int32> (Only where type is BENEFICIAL_OWNER) Percentage ownership of the corporation (0 to 100)
title	string Example values CEO, COO, CFO, President, BenefitsAdministrationOfficer, CIO, VP, AVP, Treasurer, Secretary, Controller, Manager, Partner or Member.
us_residency_status	string US Residency Status Enum: "US_CITIZEN" "RESIDENT_ALIEN" "NON_RESIDENT_ALIEN"

Responses

200

Success

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Error

post/v1/customers/{id}/individuals

Request samples

Payload

application/json

{"individual_type": ["INDIVIDUAL"
],
"first_name": "string",
"middle_name": "string",
"last_name": "string",
"email_address": "string",
"mailing_address": {"unit_number": "string",
"address_line1": "string",
"address_line2": "string",
"address_line3": "string",
"city": "string",
"state": "string",
"postal_code": "string",
"country_code": "string"
},
"telephone_number": "string",
"tax_reference_number": "string",
"passport_number": "string",
"nationality": "string",
"date_of_birth": "2019-08-24",
"percentage_ownership": 0,
"title": "string",
"us_residency_status": "US_CITIZEN"
}

Response samples

application/json

{"data": {"id": "string"
}
}