Skip to main content
POST
Create Deadline Reminder
Credits: 0 per request. Subscribes an email address to deadline reminders. Requires portfolios:manage and an Idempotency-Key header. Free. 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.
What a reminder contains and when it is sent is in Deadline Reminders.