Skip to content

Notifications API

Service: $client->notifications()

Send organization notifications

$request = new SendNotificationRequest(
    userIds: [$developerA, $developerB],
    title: 'Deployment window changed',
    body: 'Production deployment starts at 18:00.',
    url: '/app/projects/' . $projectId,
);

$response = $client->notifications()->send($organizationId, $request);

Route: POST /organizations/{organization}/notifications
Scope: notifications:write

Schema limits: 1-100 recipients, title up to 180 characters, body up to 2000 characters. External URLs are rejected locally.

Recipient membership is validated server-side. Locally valid requests may return 422 if a recipient is invalid for the credential organization.