Skip to main content

Send a notification with digest aggregation

POST 

/api/v1/notifications/manage/send-with-digest

Triggers a notification workflow that must already have a digest step configured. The workflow’s configured digest window determines whether and how events are batched before delivery; this operation does not create that digest configuration.

Acceptance is not a delivery or read receipt. Workflow configuration, recipient preferences and provider delivery can produce later failures or suppression. A transactionId is a provider correlation/deduplication input, not an unlimited exactly-once guarantee or an authorization grant; reconcile uncertain sends before retrying.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Send notifications

Request​

Responses​

Digest notification accepted

Submit one event to a workflow that already has a digest step configured.​

Section ID: DOC-CP-notifications-api-sendWithDigest#example-notifications-sendWithDigest-request

Request example

{
"workflowId": "activity-digest",
"userId": "user-1",
"payload": {
"title": "Account activity",
"body": "A new report is available."
}
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.​

Section ID: DOC-CP-notifications-api-sendWithDigest#example-notifications-sendWithDigest-response

Response example

{
"acknowledged": true,
"status": "example",
"transactionId": "example_123",
"errors": [
"example"
]
}

Document ID: DOC-CP-notifications-api-sendWithDigest. Section identities and revisions.

SectionStable reference
Send a notification with digest aggregationDOC-CP-notifications-api-sendWithDigest#overview
RequestDOC-CP-notifications-api-sendWithDigest#request
ResponsesDOC-CP-notifications-api-sendWithDigest#responses