Create a signatory for a customer

Creates a new signatory for the given customer.

Access and authorization

  • Appropriate Open Banking access is required (implementation uses permission mCust; HTTP status for unauthenticated or forbidden callers may depend on your API gateway).
  • The caller's partner identifier must be present in the security context (SIG_PARTNERID_REQUIRED if missing).
  • The service resolves the caller's legal entity from the token and verifies the requested customer is allowed for that caller (SIG_CUSTOMERACCESS_DENIED if not).
  • If no customer exists for customerId, the request fails (SIG_CUSTOMERNOTFOUND).

Validation

  • fullName, emailAddress, and phoneNumber are required; title and approvalLimit are optional.
  • Email: must be a valid address format and must be unique where required by platform rules; duplicate or invalid submissions return a validation or business error with a message and code from the backend.
  • Phone: must pass the legal-entity validate-phone check (SIG_PHONE_INVALID, or an integration failure code if the validator cannot be reached).
  • Approval limit: when provided, must be non-negative and within the integer/fraction digit limits enforced by the API.

Returns HTTP 201 Created with the new signatory identifier and downstream status fields.

SecurityoAuth2
Request
Request Body schema: application/json
required
fullName
required
string

Full name of the signatory (required, not blank).

emailAddress
required
string <email>

Email address (required, valid email format).

title
string

Optional job title or role label.

approvalLimit
number <double>

Optional monetary approval limit. If provided, must be >= 0 with at most 12 integer digits and 2 decimal places.

phoneNumber
required
string

Phone number (required). Validated against the legal-entity phone validation service after format checks.

Responses
201

Signatory created

400

Validation or business rule failure. Body uses errors array (message, code). Common codes include SIG_FULLNAME_REQUIRED, SIG_EMAIL_REQUIRED, SIG_EMAIL_INVALID, SIG_PHONE_REQUIRED, SIG_APPROVALLIMIT_MIN, SIG_APPROVALLIMIT_INVALID, SIG_PHONE_INVALID, SIG_PARTNERID_REQUIRED, SIG_CUSTOMERNOTFOUND, SIG_CUSTOMERACCESS_DENIED, SIG_VALIDATION_ERROR, SIG_SERVICECALL_FAILED.

401

Not authenticated (gateway / OAuth — behavior may vary)

403

Authenticated but missing required permission for this resource

500

Internal server error

post/v1/customers/{customerId}/signatories
Request samples
application/json
{
  • "fullName": "Jane Doe",
  • "emailAddress": "jane.doe@example.com",
  • "title": "CFO",
  • "approvalLimit": 100000.5,
  • "phoneNumber": "+15551234567"
}
Response samples
application/json
{
  • "id": 0,
  • "status": "string",
  • "message": "Signatory created successfully."
}