Notify/remind all pending signers in a package
Monday, June 22, 2026 at 04:07pmHi OneSpan Team,
I’m working on an integration for OneSpan Sign and need to confirm available API capabilities for signer reminders.
Requirement
- We have a package/transaction with multiple signers.
- We need to trigger reminder notifications from our application for multiple signers in one user action.
- Preferred behavior: provide only packageId (or package + list of signers) and have OneSpan send reminders to all eligible/pending signers in one API call.
What we found so far
- Single signer notification API:
- POST /api/packages/{packageId}/roles/{roleId}/notifications
- Works per signer (roleId), one call at a time.
- Reminder schedule APIs (/api/packages/{packageId}/reminders) appear to be scheduled/automated reminders, not an immediate one-time “notify all now” endpoint.
Questions for confirmation
- Does OneSpan provide any API to immediately notify all pending/incomplete signers of a package in a single call?
- Does OneSpan provide any API to immediately notify a list of signer roleIds in a single call (bulk notify)?
- If neither exists, is the recommended approach to call POST /api/packages/{packageId}/roles/{roleId}/notifications once per signer?
- For POST/PUT /api/packages/{packageId}/reminders, are reminder emails sent only to signers with pending actions, or to all signers in the package including already completed signers?
Thanks in advance - this confirmation will help us finalize our integration design.
Reply to: Notify/remind all pending signers in a package
Thursday, July 2, 2026 at 08:08amHello Vanitha,
Thank you for the question.
Please find the answers below:
1. Does OneSpan provide any API to immediately notify all pending/incomplete signers of a package in a single call?
A. At this point, we don't have a single call to notify all pending/incomplete signers.
2. Does OneSpan provide any API to immediately notify a list of signer roleIds in a single call (bulk notify)?
A. No.
3. If neither exists, is the recommended approach to call POST /api/packages/{packageId}/roles/{roleId}/notifications once per signer?
recommended
A. You may create a script to run batch API calls to notify the signers. Please note that with this call, even the signer who has completed their signature will receive an email notification if a POST call is made for that signer. Taking that into consideration, you may set up a reminder schedule for the account or at the transaction level
4. For POST/PUT /api/packages/{packageId}/reminders, are reminder emails sent only to signers with pending actions, or to all signers in the package, including already completed signers?
A. Reminders will only be sent to the signers with pending actions.
Also, we have 2 different email templates that handle this :
1. email.notify - When a notification is either manually triggered or via API [POST /api/packages/{packageId}/roles/{roleId}/notifications]
2. email.remind.signer - When a signer is automatically notified about the pending signatures as per the reminder set.
Please let us know if you have any questions for us.
Thank you
Reply to: Notify/remind all pending signers in a package
Thursday, July 2, 2026 at 09:05amHi OneSpan Team,
Thank you for your response. We need one additional clarification to finalize our design.
If we need a user-triggered action to notify all pending signers for a package, can we use the reminder schedule APIs (POST/PUT /api/packages/{packageId}/reminders) as an immediate substitute for bulk notify?
Specifically, can you confirm:
This confirmation will help us decide between per-signer notification calls vs reminder-schedule-based flow.
Thanks!