Actions33
- Template Actions
- Document Actions
- Signer Actions
- Background Check Actions
- Partnership Actions
- Timestamp Actions
- Webhook Actions
Overview
This node integrates with the ZapSign API to manage electronic document signing workflows. Specifically, for the Signer resource and the Reset Validation Attempts operation, it allows users to reset the number of validation attempts a signer has made during the signing process. This can be useful if a signer has exceeded their allowed validation tries (e.g., entering authentication codes) and needs to be granted additional attempts without creating a new signer or document.
Typical use cases include:
- Allowing a signer to retry identity verification after failed attempts.
- Managing signer access control dynamically in automated document workflows.
- Recovering from temporary lockouts due to validation failures.
Example: If a signer is locked out after multiple failed SMS token entries, this operation resets their attempt count so they can try again.
Properties
| Name | Meaning |
|---|---|
| Signer Token | The unique token identifying the signer whose validation attempts you want to reset. |
Output
The output JSON contains the response from the ZapSign API after resetting the validation attempts for the specified signer. It typically includes confirmation details such as success status and any relevant metadata returned by the API.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the ZapSign API via an API key credential configured in n8n.
- The node uses environment variables to determine the API base URL (
ZAPSIGN_API_BASE_URL_SANDBOXfor sandbox orZAPSIGN_API_BASE_URLfor production). - Network access to the ZapSign API endpoints is necessary.
Troubleshooting
Common Issues
- Missing or invalid signer token: The operation requires a valid signer token; ensure the token is correctly provided.
- Network or authentication errors: Verify that the API credentials are correct and have sufficient permissions.
- API endpoint unreachable: Check network connectivity and environment variable configuration for the API base URL.
Error Messages
- If the signer token is missing or empty, the node throws an error indicating the requirement.
- API errors during the reset attempt request are logged and rethrown. Users should check the error message for details.
- No specific error handling for 4xx or 5xx HTTP statuses is shown beyond logging; users should verify API responses manually if issues arise.
Links and References
- ZapSign API Documentation (general reference for API endpoints and usage)
- n8n documentation on creating custom nodes
- ZapSign support for account and API access issues
This summary focuses exclusively on the Signer - Reset Validation Attempts operation as requested.