---
title: "Resend TOA Packet"
url: "https://developers.zinnia.com/apis/new-business-annuity/versions/45a989ab-c3aa-4f85-8f67-f05c41747ed7/operations/resendToaPacket"
---

> Full API specification: https://developers.zinnia.com/apis/new-business-annuity/versions/45a989ab-c3aa-4f85-8f67-f05c41747ed7.md

# Resend TOA Packet

`POST` `/v1/toa/resend-packet`

Operation ID: `resendToaPacket`

Records receipt of a request from the Resend TOA Packet screen and returns a receipt. This endpoint does not start a Camunda process, update a contract, or invoke an external packet-delivery service.

## Request body (required)

Content types: `application/json`

## Responses

- `202` - TOA packet resend request received.
- `400` - Required request data is missing or the delivery-method override is invalid.
- `401` - Authentication failed
- `403` - Access denied

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Zinnia New Business Annuity API
  version: 0.8.0
servers:
  - url: https://qa.api.zinnia.io
    description: QA Environment
  - url: https://dev.api.zinnia.io
    description: DEV Environment
  - url: https://uat.api.zinnia.io
    description: UAT Environment
  - url: https://api.zinnia.io
    description: PROD Environment
paths:
  /v1/toa/resend-packet:
    post:
      tags:
        - TOA
      summary: Resend TOA Packet
      description: >
        Records receipt of a request from the Resend TOA Packet screen and
        returns

        a receipt. This endpoint does not start a Camunda process, update a
        contract,

        or invoke an external packet-delivery service.
      operationId: resendToaPacket
      requestBody:
        required: true
        description: Details needed to resend a TOA packet.
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/ResendToaPacketRequest"
            example:
              requestSource: Call
              callerName: Jane Doe
              codingCarrier: Mass Mutual Life Insurance Company
              codingContractNumber: "797897987"
              contractNumber: "797897987"
              resendReason: Customer request
              updateDeliveryMethod: true
              deliveryMethod: EMAIL
      responses:
        "202":
          description: TOA packet resend request received.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResendToaPacketResponse"
              example:
                status: ACCEPTED
                message: TOA packet resend request received.
                codingContractNumber: "797897987"
                contractNumber: "797897987"
        "400":
          description: Required request data is missing or the delivery-method override is
            invalid.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResendToaPacketValidationError"
              example:
                message: deliveryMethod must be ADDRESS, EMAIL, or FAX when updateDeliveryMethod
                  is true.
        "401":
          description: Authentication failed
        "403":
          description: Access denied
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AccessDeniedResponse"
      security:
        - Auth0: []
security:
  - Auth0: []
components:
  schemas:
    ResendToaPacketRequest:
      type: object
      additionalProperties: false
      required:
        - requestSource
        - codingCarrier
        - codingContractNumber
        - resendReason
        - updateDeliveryMethod
      properties:
        requestSource:
          type: string
          minLength: 1
          description: Origin of the request, for example `Call`.
          example: Call
        callerName:
          type: string
          description: Name of the caller who requested the resend.
          example: Jane Doe
        codingCarrier:
          type: string
          minLength: 1
          description: Carrier selected for coding.
          example: Mass Mutual Life Insurance Company
        codingContractNumber:
          type: string
          minLength: 1
          description: Coding contract number shown in the resend screen.
          example: "797897987"
        contractNumber:
          type: string
          description: Additional contract number supplied by the calling system.
          example: "797897987"
        resendReason:
          type: string
          minLength: 1
          description: Reason the TOA packet is being resent.
          example: Customer request
        updateDeliveryMethod:
          type: boolean
          description: Indicates whether the delivery method must be overridden.
          example: true
        deliveryMethod:
          type: string
          pattern: ^([Aa][Dd][Dd][Rr][Ee][Ss][Ss]|[Ee][Mm][Aa][Ii][Ll]|[Ff][Aa][Xx])$
          description: Required when `updateDeliveryMethod` is `true`; accepts ADDRESS,
            EMAIL, or FAX case-insensitively.
          example: EMAIL
      allOf:
        - if:
            properties:
              updateDeliveryMethod:
                const: true
            required:
              - updateDeliveryMethod
          then:
            required:
              - deliveryMethod
    ResendToaPacketResponse:
      type: object
      required:
        - status
        - message
        - codingContractNumber
      properties:
        status:
          type: string
          enum:
            - ACCEPTED
          description: Receipt status.
          example: ACCEPTED
        message:
          type: string
          description: Receipt message.
          example: TOA packet resend request received.
        codingContractNumber:
          type: string
          description: Coding contract number from the request.
          example: "797897987"
        contractNumber:
          type: string
          description: Contract number from the request, when supplied.
          example: "797897987"
    ResendToaPacketValidationError:
      type: object
      required:
        - message
      properties:
        message:
          type: string
          description: Description of the validation failure.
          example: deliveryMethod must be ADDRESS, EMAIL, or FAX when updateDeliveryMethod
            is true.
    AccessDeniedResponse:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
        message:
          type: string
          example: "User is not authorized for the carrier : CarrierName_1"
  securitySchemes:
    Auth0:
      type: openIdConnect
      openIdConnectUrl: https://login.qa.zinnia.com/.well-known/openid-configuration
      x-kong-security-openid-connect:
        config:
          run_on_preflight: true
          scopes_claim:
            - https://qa.api.zinnia.io/permissions
          audience_claim:
            - aud
          audience_required:
            - https://qa.api.zinnia.io
          client_id:
            - client_id
          auth_methods:
            - bearer
        enabled: true
        protocols:
          - grpc
          - grpcs
          - http
          - https
```