> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Deadline Reminders

> Get an email before each trademark deadline in your docket falls due

Deadline reminders email an address before the deadlines in your
[docket](https://docs.signa.so/api-reference/reference/list-deadlines.md) fall due. Signa sends them
itself, so unlike a [calendar feed](https://docs.signa.so/guides/calendar-feeds.md) they do not wait
on a calendar app's refresh. Use them for the deadlines you must not
miss.

> [!NOTE]
>
> We are switching the docket on organization by organization. Until it is on
> for yours, the reminder routes answer `403` with code `docket_not_enabled`.
> Email [support@signa.so](mailto:support@signa.so) to have it switched on.

## Subscribe an address

```typescript theme={null}
await signa.deadlineReminders.create({
  email: 'docketing@example.com',
  portfolio_id: 'ptf_019d2141-6ce9-771b-872e-bc8b20e49fcf', // optional
  offsets: [90, 30, 7, 1], // the default
});
```

The address gets a confirmation email right away. **Nothing else is sent
until its owner clicks the link and confirms.** This keeps reminders out of
inboxes that never asked for them, and proves the address works before you
rely on it. [List Deadline Reminders](https://docs.signa.so/api-reference/reference/list-deadline-reminders.md)
shows `status: "active"` once it is confirmed.

The confirmation link works for 7 days. If the email did not arrive or the
link expired, create the subscription again: while it is still `pending`, that
mails a fresh link instead of failing. An address receives at most 3
confirmation emails a day.

Subscribe a shared docketing inbox as well as the people who work the
deadlines, so a reminder survives someone leaving.

## When a reminder is sent

Each day Signa rechecks the docket against office data, then emails every
confirmed address about each open deadline that has crossed one of its
`offsets` since the last email. With the default offsets that is 90, 30, 7 and
1 days before the due date.

* One email per address per day, listing every deadline that crossed an
  offset that day. When more than 100 are due the same day, they are split
  over several emails of up to 100 deadlines each.
* Each deadline is reminded once per offset and due date. If a day is missed,
  the next email names only the latest offset crossed, not every one in
  between.
* If a due date moves, its offsets start over for the new date. A deadline
  whose date changed in that day's recheck goes out that day, with the new
  date.
* Deadlines marked done or dismissed are not reminded.
* The last reminder of a deadline still goes out after its due date if it
  could not be sent before (an email that failed, or a date that moved to
  today or earlier): until the grace period ends, or for 3 days when there is
  none. The email says how many days overdue it is.
* If Signa's email provider refuses an email, Signa retries it on the
  following days, up to five times. If the provider does not answer, Signa
  repeats the same email with the same content, which the provider delivers
  at most once.

Deadlines newly flagged for review (a due date that moved after you marked
the deadline done, or a deadline Signa no longer computes from office data)
are emailed too, each flag once: in a separate section of that day's
reminder, or in an email of their own when nothing is due.

## What a reminder says

For each deadline: the mark, the office and the mark's number, what is due,
the due date and how many days are left, the end of the grace period where
there is one, when Signa last checked the mark against office data, and a
link to the office's record. Deadlines you added yourself say that Signa does
not check their dates. A date the office's published closure days do not yet
cover says so: "Office closure days are not confirmed for this date; check
the office calendar."

Signa computes dates from office data. Verify each one against the office
before you act on it.

**Notes and assignees are never in a reminder**, because you may subscribe an
address outside your team.

## Unsubscribe and manage

Every reminder carries an unsubscribe link, and mail apps that support
one-click unsubscribe show their own button for it. Unsubscribing deletes the
subscription; to receive reminders again, subscribe the address anew (it
confirms again).

From the API, change a subscription's offsets with
[Update Deadline Reminder](https://docs.signa.so/api-reference/reference/update-deadline-reminder.md)
and stop it with
[Delete Deadline Reminder](https://docs.signa.so/api-reference/reference/delete-deadline-reminder.md).
Deleting a portfolio deletes the subscriptions limited to it. An organization
can have 50 subscriptions. Reminders are free.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.