Skip to main content

CreateAgentDto

typestring

Possible values: [licensed_agent, introducer, corporate]

Default value: licensed_agent
firstNamestringrequired

Possible values: non-empty and <= 100 characters

lastNamestringrequired

Possible values: non-empty and <= 100 characters

emailstringrequired
phonestringrequired

Possible values: >= 6 characters

nationalIdstringrequired

National Identification Number (NIN). Mandatory for every agent. Validated against the ZFA "national_id" IdPattern when configured.

Possible values: >= 4 characters and <= 40 characters, Value must match regular expression /^[A-Za-z0-9\-\/]+$/

iraRegistrationNumberstring

IRA (Insurance Regulatory Authority) registration number. Required for licensed agents; validated against the ZFA IdPattern when configured.

Possible values: >= 3 characters and <= 40 characters, Value must match regular expression /^[A-Za-z0-9\/\-]+$/

Example: IRA/AG/2026/00123
iraRegistrationExpiresAtstring

Expiry date of the IRA registration.

insurelinkAgencyNumberstring

InsureLink Agency Number assigned by Zachary Financial Agency. Must be unique when set.

Possible values: >= 3 characters and <= 40 characters, Value must match regular expression /^[A-Za-z0-9\-]+$/

Example: ZFA-AG-000123
taxPinstring

Tax PIN / TIN. Validated against the ZFA "tax_pin" IdPattern when configured.

Possible values: >= 4 characters and <= 40 characters, Value must match regular expression /^[A-Za-z0-9\-]+$/

addressstring

Possible values: >= 3 characters and <= 500 characters

tierstring
sponsorAgentIdstring

UUID of the sponsoring licensed agent. Required when type is "introducer". Non-licensed introducers must be attached to a licensed agent so ZFA does not engage them directly.

CreateAgentDto
{
  "type": "licensed_agent",
  "firstName": "string",
  "lastName": "string",
  "email": "string",
  "phone": "string",
  "nationalId": "string",
  "iraRegistrationNumber": "IRA/AG/2026/00123",
  "iraRegistrationExpiresAt": "string",
  "insurelinkAgencyNumber": "ZFA-AG-000123",
  "taxPin": "string",
  "address": "string",
  "tier": "string",
  "sponsorAgentId": "string"
}