ErrorResponse
object>= 1 characters
Example:{"code":"VALIDATION_ERROR","description":"Input validation failed","details":"One or more input fields are invalid","timestamp":"2024-01-15T10:30:00.000Z"}
Show Child Parameters
FieldBlueprint
objectThe type of field displayed for collecting response values:
money - Currency input field
date - Date selection input field
information - Read-only informational text display field
radio - Single-selection radio button field
input - Free-form text input field
email - Email address input field
dropdown - Selection field with predefined options
phone - Phone number input field
checkboxgroup - Checkbox group field for multiple selections
number - Number input field for numeric values
checkbox - Checkbox field for single selection (value is string)
Allowed values:moneydateinformationradioinputemaildropdownphonecheckboxgroupnumbercheckbox
The text associated with a field title, such as descriptions or related notes. Supports localization through language codes (e.g., en, fr)
Show Child Parameters
The field title in multiple languages. Supports localization through language codes (e.g., en, fr)
Show Child Parameters
A unique identifier used to store and infer a field’s answer, and to build validation and visibility conditions across the order entry blueprint
Single condition controlling whether a field/section is rendered.
Show Child Parameters
An array of platforms where this field is available (e.g., D2C-only versus advisor-driven experiences)
A comma-separated list of roles (e.g., annuitant, insured, owner, payor) that are allowed to copy this field.
Indicates whether the field triggers step navigation
Layout options for the field. Used to define the field’s rendered width in the 12-column grid.
Show Child Parameters
Indicates whether this field should be displayed in card preview mode
Array of application modes where this field is available. Helper for filtering what is shown in different modes or channels
List of localized default text values for the field. When rendered, the appropriate localized text is displayed as the field’s initial answer until modified.
Show Child Parameters
The unique identifier for the field
>= 1 characters
An identifier (partName) for the field.
>= 1 characters
Validation type applied to fields such as phone numbers, where the value must contain digits only. These validations exist and are managed through Zinnia Form Engine SDK
Array of options (answers) that can be selected for dropdown, radio, checkbox, or checkboxgroup fields
Show Child Parameters
Application context for select options sourced from subscriber dataset
Example:{"tag":"507602","labelKey":{"en":"Name"},"valuePath":"Value"}
Show Child Parameters
Visibility settings containing a boolean operator and an array of conditions that determine when the field is visible.
Example:{"booleanOperator":"AND","conditions":[{"type":"equality","isEqual":true,"value":"Yes","targetNodeId":"Transaction.SolicitationState"},{"type":"equality","isEqual":true,"value":"Yes","targetNodeId":"Transaction.SolicitationState"}]}
Show Child Parameters
An array of validation rules applied to the field (e.g., regex, number range, character count)
Example:{"message":{"en":"Please enter valid email address"},"conditions":{"conditions":[{"type":"matchesRegexCondition","targetNodeId":"Transaction.Beneficiaries[0].EmailAddresses[\"Home\"].Address","regex":"^\\w+([-+.']\\w+)*@\\w+([-.]\\w+)*\\.\\w+([-.]\\w+)*$"}]}}
Show Child Parameters
Indicates if this field is optional (not required)
FieldGroupBlueprint
objectThe unique identifier for the field group
>= 1 characters
An identifier (partName) for the field group
>= 1 characters
The text associated with a field group, such as descriptions or related notes. Supports localization through language codes (e.g., en, fr).
Show Child Parameters
The title of the field group in multiple languages. Supports localization through language codes (e.g., en, fr).
Show Child Parameters
Indicates whether this is a custom field group
Array of fields (questions) within this field group
Show Child Parameters
Indicates if this field group should be displayed as a card
Role identifier controlling copy behavior. Use ‘none’ to disable copying, or a role name (e.g., ‘owner’, ‘annuitant’, ‘insured’, ‘payor’). Multiple roles may be comma-separated.
FieldValidationRule
objectLocalized message displayed to the user when validation fails
Show Child Parameters
The validation conditions wrapper containing an optional booleanOperator and an array of individual conditions
LayoutSettings
objectThe size of the field in a 12-column HTML grid that determines its rendered width (12 = full-width, 6 = half-width, 4 = one-third, 3 = quarter-width). Field column widths sum to 12 per row - e.g., two fields of 6 sit side-by-side, three fields of 4 share a row, four fields of 3 share a row.