---
title: "SaveEsignatureRequest"
url: "https://developers.zinnia.com/apis/market-connect-order-entry/versions/50f981c3-db50-4358-884f-31eb427255ec/schemas/SaveEsignatureRequest"
---

> Full API specification: https://developers.zinnia.com/apis/market-connect-order-entry/versions/50f981c3-db50-4358-884f-31eb427255ec.md

# SaveEsignatureRequest

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Market Connect Order Entry API
  version: 1.0.4
servers:
  - url: https://dev.api.zinnia.io
  - url: https://qa.api.zinnia.io
  - url: https://uat.api.zinnia.io
components:
  schemas:
    SaveEsignatureSignerRequest:
      type: object
      properties:
        recipientId:
          type: string
          description: DocuSign recipient ID from GET signers (required for submission).
          nullable: true
        signerAccessCode:
          type: string
          description: Access code when required; empty string when none.
          nullable: true
        signerAuthMethod:
          type: string
          description: Selected auth method for submission (for example Phone).
          nullable: true
        signerCountryCode:
          type: string
          description: Country calling code (default 1 for US).
          nullable: true
        signerEmail:
          type: string
          description: Signer email; may be empty for some roles.
          nullable: true
        signerEntityRole:
          type: string
          description: Entity role (for example PrimaryOwner, AgentOfRecord).
          nullable: true
        signerName:
          type: string
          description: Display name sent to DocuSign for this recipient.
          nullable: true
        signerPhoneNo:
          type: string
          description: Phone digits only; stored without dashes.
          nullable: true
        signerSequence:
          type: string
          description: Signing order when routing is sequential.
          nullable: true
      additionalProperties: false
    SaveEsignatureRequest:
      required:
        - signers
      type: object
      properties:
        transactionId:
          minimum: 1
          type: integer
          description: Transaction (case) identifier to submit for e-signature.
          format: int64
        signers:
          minItems: 1
          type: array
          items:
            $ref: "#/components/schemas/SaveEsignatureSignerRequest"
          description: Final signer roster with selected auth method and contact details.
      additionalProperties: false
      example:
        transactionId: 1131068
        signers:
          - recipientId: "11306862"
            signerAccessCode: ""
            signerAuthMethod: Phone
            signerCountryCode: "1"
            signerEmail: anannya.gupta@everglades.com
            signerEntityRole: PrimaryOwner
            signerName: EE EE1
            signerPhoneNo: "8650827071"
            signerSequence: "1"
          - recipientId: "11306935"
            signerAccessCode: ""
            signerAuthMethod: Phone
            signerCountryCode: "1"
            signerEmail: ""
            signerEntityRole: AgentOfRecord
            signerName: RR RR
            signerPhoneNo: "8650827071"
            signerSequence: "2"
```