Policy Transactions
PartyUpdate
objectA single party change entry (pa-bpm-txn-common PartyUpdateDto). One
MultiPartyRoleChangeRequest carries a list of these - one per party being
added, updated, or removed in this transaction.
actionstringrequired
Action to apply for this party update entry
Allowed values:ADDUPDATEDELETENONE
Example:ADD
customerIdstring
Top-level customer ID. Sent alongside party.customerId for the same party.
relationshipToPartystring
partyRolestring
The specific party role for this entry. Each backing microservice sends
its own literal value today, with no shared casing convention across
services (tracked for future normalization): PAYEE (payee-change),
TRUSTEE (trustee-change), ATTORNEY_IN_FACT (poa-change),
AuthorizedSignatory (authorized-signatory-change), Owner / JointOwner
(owner-mgmt), CoverageJointInsured (rider-role-change).
Example:CoverageJointInsured
referencePartyIdstring
PartyId of an existing party on the policy to clone when adding a new
party (e.g. ADD a new Coverage Joint Insured with the same details as
an existing party). Only relevant for action ADD; not forwarded to
downstream carrier systems.
partyStatusstring
carrierDecisionstring
rejectionReasonstring
delegatedExecutionAuthorityTypestring
Power of Attorney specific - delegated execution authority type
powerOfAttorneyAccessLevelTypestring
Power of Attorney specific - access level type
partyobject
Full party detail payload (pa-bpm-txn-common PartyDetailsForPartyRoleDto).
Only the fields relevant to the action/party role need to be populated.
Show Child Parameters
Example
MultiPartyRoleChangeRequest
objectGeneric request body for a party role change transaction (pa-bpm-txn-common
MultiPartyRoleChangeRequest), shared across all multi-party-update
transactions (Payee, Trustee, Power of Attorney, Owner/Joint Owner,
Authorized Signatory, Coverage Joint Insured, and future party roles).
Each party role is exposed at its own dedicated path (see the
…/parties/{role}/… operations); this schema is the shared contract
across all of them.
planCodestring
Plan code (may duplicate path parameter)
policyNumberstring
Policy number (may duplicate path parameter)
caseIdstring
Zinnia Live Case ID
Example:CA0000007389
correlationIdstring
The unique ID to track transaction request across all systems
Example:e3bdb22b-790f-4357-ae60-42cdb0ff0d12
carrierIdstring
Carrier identifier
Example:FNWL
effectiveDatestring(date)required
Effective date for the party role change
Example:2026-07-24
requestSourcestring
Origin of the request
Allowed values:DATA_ENTRYSELF_SERVE
partyUpdatesarray[object]required
A single party change entry (pa-bpm-txn-common PartyUpdateDto). One
MultiPartyRoleChangeRequest carries a list of these - one per party being
added, updated, or removed in this transaction.
>= 1 items
Show Child Parameters
signaturesarray[object]
Signature details for the agent change
Show Child Parameters
documentsarray[object]
Supporting document reference for a party role change
Show Child Parameters
selfServeFlowboolean
Whether the request originated from a self-serve flow
Example:true
supportingDocumentAttachedboolean
Indicates whether supporting documents are attached
Example:true
changeReasonstring
Reason for the change
Example
ReinstatementQuoteRequest
objectcorrelationIdstringrequired
The unique ID to track transaction request across all systems
Example:657b717b7dcf554abf9ef067
effectiveDatestring(date)required
Date when the transaction was originally scheduled or expected to happen. It can be a non-business day
Example:2023-01-01
reverseInitiatorboolean
Property to isolate source transaction(s) that initiated the reversal
Default:false
externalIdentifiersobject
Show Child Parameters
policyobjectrequired
Show Child Parameters
Example
ReinstatementRequest
objectcorrelationIdstringrequired
The unique ID to track transaction request across all systems
Example:657b717b7dcf554abf9ef067
effectiveDatestring(date)required
Date when the transaction was originally scheduled or expected to happen. It can be a non-business day
Example:2023-01-01
reverseInitiatorboolean
Property to isolate source transaction(s) that initiated the reversal
Default:false
policyobjectrequired
Show Child Parameters
transactionAmountsobjectrequired
Show Child Parameters
systematicProgramobjectrequired
Show Child Parameters
caseIdstringrequired
Zinnia Live Case ID
Example:CA0000007389
Example
SystematicProgramUpdateRequest
objectcorrelationIdstring
The unique ID to track transaction request across all systems
Example:657b717b7dcf554abf9ef067
effectiveDatestring(date)required
Date (with pattern “yyyy-mm-dd”) when the transaction was originally scheduled or expected to happen, can be a non-business day
Match pattern:([0-9]{4})-([0-9]{2})-([0-9]{2})
reverseInitiatorboolean
Property to isolate source transaction(s) that initiated the reversal
authorizationManualboolean
Indicates manual authorization handling may apply for this submission
isFractionalAmountAuthorizedboolean
Indicates whether fractional amount authorization applies for this systematic program update
contactMFAobject
Contact channels for multi-factor authentication on systematic program transactions
Show Child Parameters
agentobject
Named participant (e.g. servicing agent or policy holder context on the request)
Show Child Parameters
policyHolderobject
Named participant (e.g. servicing agent or policy holder context on the request)
Show Child Parameters
taxWithholdingInstructionsarray[object]
Show Child Parameters
fundAllocationobject
Show Child Parameters
fundDistributionsarray[object]
Show Child Parameters
featureTransactionProductobject
Product-level transaction classification accompanying the systematic program request
Show Child Parameters
submittedDatestring(date-time)
When the transaction was submitted (ISO-8601)
Example:2026-02-27T11:55:17Z
currencystring
ISO 4217 currency code
Example:USD
systematicProgramobjectrequired
Show Child Parameters
caseIdstring
Zinnia Live Case ID
Example:CA0000007389
externalTransactionIdstring
Transaction ID from external system
Example:A12345
Example