Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.finventi.com/llms.txt

Use this file to discover all available pages before exploring further.

This webhook is sent when an account creation request has failed.

​
Webhook Structure

​
id
string (UUID)
required
Unique identifier for this event
​
time
string (ISO 8601)
required
Timestamp of when the event occurred
​
correlationId
string
Identifier to correlate the request with the response. Present when provided in the original request.
​
type
string
required
The type of event. Value: account.creation-failed
​
data
object
required
The event data containing the details below

​
Data Fields

​
data.partyId
string (UUID)
required
Unique identifier of the party for which account creation failed
​
data.errors
array
required
List of errors that caused the failure

​
Error Codes

New error codes may be added in future versions. Consumers should handle unknown codes gracefully.
CodeDescription
PARTY_NOT_FOUNDParty not found
UNKNOWN_ERRORUnknown error
SYSTEM_ERRORInternal 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"
      }
    ]
  }
}
Last modified on May 5, 2026