Skip to main content

Send a notification from an inbox rule

POST 
/communications/inbox_rule/:id/emission

Sends a notification from one of your invoked inbox rules: the resource the event is about (nrn) and the data the rule's templates read (context).

Sends are idempotent by context.id. Sending the same id for the same nrn again answers 200, marks each entry in emitted with existing: true, and creates nothing. Sending it for a different nrn answers 409.

Recipients who can't see the resource are left out and counted in rejected, and people who turned the rule off for that resource don't receive it.

Request​

Responses​

A retry of an earlier send, nobody was left to notify, or a dry run.

With dry_run=true, the body describes what would be sent: would_emit, rejected, and unreached when a reading would reach nobody.