> ## 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.

# Create Deadline Reminder

> Email an address before your trademark deadlines fall due

**Credits:** 0 per request.

Subscribes an email address to deadline reminders. Requires
`portfolios:manage` and an `Idempotency-Key` header. Free.

| Field | Required | Meaning |
| - | - | - |
| `email` | yes | Where reminders go: a person or a shared docketing inbox. |
| `portfolio_id` | no | Limit the reminders to one portfolio. Omit it for the whole docket. 404 for a portfolio outside your organization. |
| `offsets` | no | Days before each due date to remind, 0 (the due date itself) to 365. Default `[90, 30, 7, 1]`. Up to 8 values. |

The response is the subscription with `201 Created` and `status: "pending"`.
Signa emails the address a confirmation link at once, and **sends no reminder
until the address owner confirms**. Once they do, `status` turns `active`.
The confirmation link works for 7 days. If the email provider refuses the
confirmation email, the request fails with 503 and nothing is created or
changed; retry later.

An address can have one subscription per scope (a portfolio, or the whole
docket). Creating again while that subscription is still `pending` mails a
fresh confirmation link and takes the new `offsets`: use it when the first
email did not arrive or its link expired. Once the subscription is `active`, a
second one for the same scope returns 409 `deadline_reminder_exists`. An
organization can have 50 subscriptions; a 51st returns 409
`resource_quota_exceeded`.

Confirmation emails are limited: an address receives at most 3 a day from
all organizations together, and an organization sends at most 50 a day.
Past either limit the request returns 429 `rate_limited` with `Retry-After`,
and nothing is created or sent.

```typescript theme={null}
const reminder = await signa.deadlineReminders.create({
  email: 'docketing@example.com',
  offsets: [90, 30, 7, 1],
});
console.log(reminder.status); // "pending" until the address confirms
```

What a reminder contains and when it is sent is in
[Deadline Reminders](https://docs.signa.so/guides/deadline-reminders.md).


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