Resend Signature Request

Resend a signature request reminder email to specific recipients who haven't yet signed the handbook.

Mutation

mutation ResendSignatureRequest(
  $handbookId: Int!
  $formId: String!
  $emails: [String!]!
) {
  resendSignatureRequest(
    handbookId: $handbookId
    formId: $formId
    emails: $emails
  ) {
    success
    message
  }
}

Parameters

Parameter	Type	Required	Description
handbookId	Int!	Yes	The handbook ID
formId	String!	Yes	The Firma form ID (from getSignatureSignees response)
emails	[String!]!	Yes	Email addresses of recipients to resend to

Response

{
  "data": {
    "resendSignatureRequest": {
      "success": true,
      "message": "Signature request reminder sent successfully."
    }
  }
}

Examples

Resend to a Single Recipient

First, get the formId from getSignatureSignees:

query {
  getSignatureSignees(handbookId: 123) {
    signees {
      email
      formId
      signedAt
    }
  }
}

Then resend to unsigned recipients:

mutation {
  resendSignatureRequest(
    handbookId: 123
    formId: "abc-123-def"
    emails: ["[email protected]"]
  ) {
    success
    message
  }
}

Error Responses

Subscription Required

{
  "errors": [{ "message": "This operation requires an active subscription. ONE_TIME or unsubscribed handbooks are not supported." }]
}

Access Denied

{
  "errors": [{ "message": "Handbook not found or access denied" }]
}

Notes

• Requires bearer token authentication
• Requires an active subscription (SUBSCRIPTION status) — ONE_TIME or unsubscribed handbooks are not supported
• The formId can be obtained from the getSignatureSignees query response
• Sends a fresh signing email to each specified recipient
• Typically used to remind employees who haven't yet signed