Menu

Notifications

1 endpoint in the Mattering Productivity API.

POST notifications/send/ User APIService tier

Send a ``productivity.message`` platform notification to named people.

config: message (required, plain text), optional title, the recipients as recipient_id (one email, username or user id) and/or recipient_ids / recipients / recipient_emails (lists), and an optional task_id or project_id the notification links to. channel is accepted and ignored (in-app is the only channel).

The caller is the actor. Only current members of this workspace who could open the linked task / project (or, with no link, the workspace) receive it; anyone else is dropped silently. No named recipient means nobody. Rate limited to notify.MESSAGE_RATE_LIMIT recipients per organization per hour. results.notifications_sent is how many were notified.

This read is not paginated. It returns at most 8 rows and does not report a total, so a result of exactly 8 may be truncated.

URL

  • User APIhttps://productivity.mattering.io/api/user/v1/notifications/send/
  • Service tierhttps://productivity.mattering.io/api/internal/notifications/send/

Body keys (JSON)

KeyRequiredDefault
configoptional or conditionalnone
space_idoptional or conditionalnone
user_idoptional or conditionalnone

Keys the view reads. A key not in this list is ignored by the view. Where a key is required only for some actions (for example the action dispatch), the description above says which.

Responses

200 bare JSON object (no envelope)

{
  "success": true,
  "results": [
    "..."
  ],
  "warning": "rate_limited: some recipients were not notified (per-organization hourly limit)"
}

Field names come from the code; values are placeholders (... is a string, 0 a number, dates are ISO 8601).

Errors

StatusCode
400invalid_config
401missing_actor
401unauthorized
403forbidden
404project_not_found
404task_not_found

Example

curl -X POST "https://productivity.mattering.io/api/user/v1/notifications/send/" \
  -H "Authorization: Bearer $MATTERING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "config": "...",
  "space_id": "...",
  "user_id": "..."
}'

Source: MatteringPMCore/internal_api.py (internal_api.internal_send_notification)

All Productivity resources
Start Free Explore our Products