Skip to content

Suppression

A Suppression is an address a Company never sends commercial Messages to, read before every send from any of its Startups.

Properties

PropertyTypeRequiredDescription
addressstringrequiredThe email address or phone number.
reasonstringWhy it is suppressed, such as an opt-out or a bounce.

Object

JSON
{
  "$id": "https://api.sb/patentpad.com/suppressions/suppression_1",
  "$type": "Suppression",
  "address": "Example address",
  "reason": "Example reason"
}

Relationships

  • A Suppression is kept by one Company: a Company’s Suppressions bind every Startup it holds: no commercial Message goes to a suppressed address. keptBy, inverse keeps.

Verbs

  1. createCreates a Suppression.
    POST /{namespace}/suppressionsdoSuppression.created
  2. getReturns one Suppression by id.
    GET /{namespace}/suppressions/{id}readNo Event
  3. listReturns Suppressions, newest first, one page at a time.
    GET /{namespace}/suppressionsreadNo Event

A Suppression is kept forever and never edited: it has no update or delete.

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
Suppression.createYesYesYesNo
Suppression.getYesYesYesYes
Suppression.listYesYesYesYes

Call it

Text
Add a suppression to ShiftNote.

Example

A florist unsubscribes from one sibling's newsletter. The Suppression, kept by their Company, stops commercial Messages to her from every Startup it holds, with reason: unsubscribed.