Party Creation Failed

Webhook Structure

string (UUID)

required

Unique identifier for this event

string (ISO 8601)

required

Timestamp of when the event occurred

string

Identifier to correlate the request with the response. Present when provided in the original request.

string

required

The type of event. Value: party.creation-failed

object

required

The event data containing the details below

Data Fields

string

required

Type of the party that failed to create. Available values: INDIVIDUAL, ORGANISATION

array

required

List of errors that caused the failure

Show Error object properties

string

required

Error code indicating the reason for the failure

string

Description of the error

New error codes may be added in future versions. Consumers should handle unknown codes gracefully.

Code	Description
`PARTY_ALREADY_EXISTS`	Party already exists
`UNKNOWN_ERROR`	Unknown error
`SYSTEM_ERROR`	Internal system error

Code

Description

PARTY_ALREADY_EXISTS

Party already exists

UNKNOWN_ERROR

Unknown error

SYSTEM_ERROR

Internal system error

Request Example

{
  "id": "a3f8e2b1-5c7d-4e9f-b8a2-1d4c6e9f0a3b",
  "time": "2025-01-15T10:30:00Z",
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "type": "party.creation-failed",
  "data": {
    "partyType": "INDIVIDUAL",
    "errors": [
      {
        "code": "PARTY_ALREADY_EXISTS",
        "message": "Party already exists"
      }
    ]
  }
}

Getting Started

Parties

Accounts

Account Statements

Payments

Transactions

Transaction Postings

Oversight

Webhooks

Webhook Structure

Data Fields

Error Codes

Request Example

​Webhook Structure

​Data Fields

​Error Codes

​Request Example

Webhook Structure

Data Fields

Error Codes

Request Example