EntityRepresentative

Create

POST

Path parameters

entityIdstringRequired

Request

This endpoint expects an object.
name
objectRequired
phone
objectRequired
email
stringRequired
address
objectRequired
birthDate
objectRequired
governmentID
objectRequired
responsibilities
objectRequired

Response

This endpoint returns an object
id
string
name
object
phone
object
email
string
address
object
birthDateProvided
boolean
governmentIDProvided
boolean
responsibilities
object
createdOn
datetime
updatedOn
datetime
disabledOn
datetimeOptional
POST
1curl -X POST https://api.mercoa.com/entity/ent_8545a84e-a45f-41bf-bdf1-33b42a55812c/representative \
2 -H "Authorization: Bearer <token>" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "name": {
6 "firstName": "John",
7 "lastName": "Adams",
8 "middleName": "Quincy",
9 "suffix": "Jr."
10 },
11 "phone": {
12 "countryCode": "1",
13 "number": "4155551234"
14 },
15 "email": "john.doe@acme.com",
16 "address": {
17 "addressLine1": "123 Main St",
18 "city": "San Francisco",
19 "stateOrProvince": "CA",
20 "postalCode": "94105",
21 "addressLine2": "Unit 1",
22 "country": "US"
23 },
24 "birthDate": {
25 "day": "1",
26 "month": "1",
27 "year": "1980"
28 },
29 "governmentID": {
30 "ssn": "123-45-6789"
31 },
32 "responsibilities": {
33 "isController": true,
34 "isOwner": true,
35 "ownershipPercentage": 40
36 }
37}'
200
Successful
1{
2 "id": "rep_7df2974a-4069-454c-912f-7e58ebe030fb",
3 "name": {
4 "firstName": "John",
5 "lastName": "Adams",
6 "middleName": "Quincy",
7 "suffix": "Jr."
8 },
9 "phone": {
10 "countryCode": "1",
11 "number": "4155551234"
12 },
13 "email": "john.doe@acme.com",
14 "address": {
15 "addressLine1": "123 Main St",
16 "city": "San Francisco",
17 "stateOrProvince": "CA",
18 "postalCode": "94105",
19 "addressLine2": "Unit 1",
20 "country": "US"
21 },
22 "birthDateProvided": true,
23 "governmentIDProvided": true,
24 "responsibilities": {
25 "isController": true,
26 "isOwner": true,
27 "ownershipPercentage": 40
28 },
29 "createdOn": "2024-01-01T00:00:00Z",
30 "updatedOn": "2024-01-01T00:00:00Z",
31 "disabledOn": null
32}