Create Signatories

Adds one or more signatories to a business (entity) client. Each element either names an existing person client (clientId) or carries the details of a new person who is created on the fly.

POST /core/signatory/{clientId}

Path Parameter

Field Name	Type	Required	Description
`clientId`	integer	TRUE	Business client the signatories belong to.

Request Body

Field Name	Type	Required	Description
`signatories`	array	TRUE	One element per signatory.
`signatories[].clientId`	integer	FALSE	Existing person client. When omitted a new person is created from the fields below.
`signatories[].officeId`	string	FALSE	Office of the new person (required for new persons).
`signatories[].firstname` / `lastname`	string	FALSE	Name of the new person.
`signatories[].emailAddress` / `mobileNo`	string	FALSE	Contact details.
`signatories[].externalId`	string	FALSE	BVN of the person.
`signatories[].nin`	string	FALSE	NIN of the person.
`signatories[].dateOfBirth`	string	FALSE	dd-MM-yyyy.
`signatories[].genderId`	integer	FALSE	Gender code value id.
`signatories[].submittedOnDate`	string	FALSE	dd-MM-yyyy.
`signatories[].address`	array	FALSE	Items of `{addressTypeId, addressLine1}`.

Response

Field Name	Type	Description
`clientId`	integer	The business client the signatories were added to.

The remaining response fields (officeId, firstname, ...) are always null; they are not populated.

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: {{tpGatewayHostUrl}}/security/authenticate

Path Params

Body Params application/json

Example

{
  "signatories": [
    {
      "clientId": 102
    },
    {
      "officeId": "1",
      "firstname": "Ada",
      "lastname": "Sample",
      "emailAddress": "ada@example.com",
      "mobileNo": "08000000000",
      "externalId": "22000000001",
      "nin": "10000000001",
      "dateOfBirth": "01-01-1990",
      "genderId": 2,
      "submittedOnDate": "01-06-2025",
      "address": [
        {
          "addressTypeId": "81",
          "addressLine1": "12 Sample Street"
        }
      ]
    }
  ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Success

Bodyapplication/json

Example

{
  "clientId": 101,
  "officeId": null,
  "firstname": null,
  "lastname": null,
  "emailAddress": null,
  "mobileNo": null,
  "externalId": null,
  "nin": null,
  "dateFormat": null,
  "locale": null,
  "submittedOnDate": null,
  "legalFormId": null
}

🟠400| Source | Error | When |

🟠401| Source | Error | When |

🟠403| Source | Error | When |

🟠404| Source | Error | When |

🔴500| Source | Error | When |

Create Signatories