Account 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: account.creation-failed

object

required

The event data containing the details below

Data Fields

string (UUID)

required

Unique identifier of the party for which account creation failed

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_NOT_FOUND`	Party not found
`UNKNOWN_ERROR`	Unknown error
`SYSTEM_ERROR`	Internal system error

Code

Description

PARTY_NOT_FOUND

Party not found

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": "account.creation-failed",
  "data": {
    "partyId": "019bdb2a-960f-789d-8955-21720e6cdeed",
    "errors": [
      {
        "code": "PARTY_NOT_FOUND",
        "message": "Party not found"
      }
    ]
  }
}

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