Skip to content

JAVA SDK v0.7.0

Choose a tag to compare

@nicolasiscoding nicolasiscoding released this 11 Aug 20:56
· 17 commits to main since this release

TurboSign — reminders and document expiration

sendReminder()

A standalone nudge for a document's outstanding signers (#61). Deliberately decoupled from the automatic schedule: it works even when reminders are disabled or the per-signer cap is spent, and it does not consume that cap.

const { results } = await TurboSign.sendReminder(documentId);
for (const r of results) console.log(`${r.recipientId}: ${r.status}`);

// or nudge specific signers
await TurboSign.sendReminder(documentId, [recipientId]);

Only signers at the current signing order are emailed; anyone else comes back as skipped with a reason rather than being silently dropped.

Per-document schedule and expiration

sendSignature() and createSignatureReviewLink() now accept reminder and expiration overrides. Omit a field to inherit the organization default.

await TurboSign.sendSignature({
  file, documentName, recipients, fields,
  remindersEnabled: true,
  reminderDelay: { value: 1, unit: 'days' },
  reminderInterval: { value: 2, unit: 'days' },
  maxReminders: 3,
  expirationEnabled: true,
  expireAfter: { value: 14, unit: 'days' },
  expirationWarning: { value: 3, unit: 'days' },
  expirationWarningInterval: { value: 1, unit: 'days' },
});

maxReminders: -1 means unlimited, 0 means none, and it never caps expiry warnings. expirationWarning: { value: 0 } disables warnings entirely.

Available in all six SDKs. Requires a backend that exposes the reminder and schedule endpoints.

Note on reminder counters

A manual sendReminder() stamps lastRemindedAt and increments the recipient's total email count, but deliberately leaves reminderCount untouched — that counter is the automatic cadence's cap budget. Code reading getRecipients() should not treat reminderCount: 0 as "never reminded".