Create notification
Create a notification about a transaction and return the created row. SaaSFlow raises most notifications itself.
Authentication
Authorization<token>A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.
companyId*stringuuidapplication/json- body
type*stringThe notification type. Only the collaboration types can be created here; SaaSFlow raises all others itself.
"assignedUser""bulkAssignedUser""taggedInComment""newComment""likedComment"recipientUserId*string1 <= lengthpayload*The fields of the chosen type and nothing else, for example transactionId, commentId, commentText and createdUserName for taggedInComment. Unknown fields or wrong types are refused with 400.
Created notification
application/json- response
id*stringuuidcompanyId*stringuuidtype*stringThe type of notification.
recipientUserId*stringThe ID of the user who should receive this notification.
readTime*|When the notification was read. Null if unread.
date-timepayload*|Type-specific notification data.
createdTime*|date-timecreatedUserId*string|nulllastUpdatedTime*|date-timelastUpdatedUserId*string|nullcurl -X POST 'https://api.saasflow.com/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/notifications' \ -H 'Content-Type: application/json' \ -d '{ "type": "assignedUser", "recipientUserId": "string", "payload": { "property1": null, "property2": null }}'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda", "type": "string", "recipientUserId": "string", "readTime": "2019-08-24T14:15:22Z", "payload": { "property1": null, "property2": null }, "createdTime": "2019-08-24T14:15:22Z", "createdUserId": "string", "lastUpdatedTime": "2019-08-24T14:15:22Z", "lastUpdatedUserId": "string"}List notifications
List a company's notifications, newest first, paginated. Notifications are what the app shows in its bell menu: bank connection failures, subscription…
Batch delete
Delete several notifications in one call by passing their ids. A caller deletes notifications addressed to themselves; deleting another user's…