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 a party 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: party.creation-failed
​
data
object
required
The event data containing the details below

​
Data Fields

​
data.partyType
string
required
Type of the party that failed to create. Available values: INDIVIDUAL, ORGANISATION
​
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_ALREADY_EXISTSParty already exists
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": "party.creation-failed",
  "data": {
    "partyType": "INDIVIDUAL",
    "errors": [
      {
        "code": "PARTY_ALREADY_EXISTS",
        "message": "Party already exists"
      }
    ]
  }
}
Last modified on May 5, 2026