For the complete documentation index, see llms.txt. This page is also available as Markdown.

Notifications API

Manage notifications, categories, and contacts with the Notifications API.

The Notifications API allows you to manage and deliver notifications within the SoftwareOne Marketplace Platform. With this API, you can:

  • Create and retrieve notification batches (emails) sent to specific categories and contacts. You can also retrieve attachments associated with those messages.

  • Create and manage notification categories (such as orders, subscriptions, and more).

  • Create and manage contacts. Contacts are the recipients who receive notifications.

  • Retrieve sent messages and delivery information.

Before you start

Review the shared API docs before you work with notifications resources.

Core concepts

The Notifications API is built around the following core resources:

  • Batch – Represents an email being sent to a specific category and multiple contacts.

  • Category – Represents a logical grouping of notifications (for example, orders or subscriptions). Categories help organize and control notification types.

  • Contact – Represents a contact who receives the notifications.

  • Message – Represents an individual notification sent to a contact, including delivery details and status.

  • Subscriber – Handles the configuration of notifications for accounts. It's the connection between an account and a notification category.

Browse collections

The API is organized into collections, each containing a set of operations. Access to these operations varies by role, depending on whether you are a client, vendor, or operations user.

Use the following links to jump to the collection you need:

Batches

View Batches operations
Operation
Method
Description
Access

POST

Creates a new batch.

vendor, ops

GET

Gets a list of batches.

vendor, ops

GET

Gets batch details.

vendor, ops

GET

Gets a batch attachment.

vendor, client, ops

Categories

View Categories operations
Operation
Method
Description
Access

POST

Creates a new notification category.

ops

GET

Gets a list of notification categories.

vendor, client, ops, contact

GET

Gets notification category details.

vendor, client, ops, contact

PUT

Updates a notification category.

ops

DELETE

Deletes a notification category.

ops

POST

Publishes a notification category.

ops

POST

Unpublishes a notification category.

ops

Contacts

View Contacts operations
Operation
Method
Description
Access

POST

Creates a new contact.

ops

GET

Gets a list of contacts.

vendor, client, ops, contact

GET

Gets contact details.

vendor, client, ops, contact

PUT

Updates a contact.

vendor, client, ops, contact

DELETE

Deletes a contact.

ops

POST

Blocks a contact.

ops

POST

Unblocks a contact.

ops

Message

View Message operations
Capability
Method
Description
Access

GET

Retrieves all messages.

vendor, client, ops

GET

Get a message by id.

vendor, client, ops

Subscriber

View Subscriber operations
Operation
Method
Description
Access

GET

Gets a list of subscribers.

vendor, client, ops

GET

Gets subscriber details.

vendor, client, ops

PUT

Modifies recipients of a given configuration.

vendor, client, ops

POST

Disables the category for the account.

vendor, client, ops

POST

Enables the category for the account.

vendor, client, ops

GET

Returns contacts configured to receive notifications for the given account and category.

vendor, ops

Template

View Template operations
Capability
Method
Description
Access

GET

Gets a list of template.

vendor, ops

POST

Creates a new template.

vendor, ops

GET

Gets template details.

vendor, ops

PUT

Updates template properties. Only speciic fields can be modified.

vendor, ops

DELETE

Permanently removes the template and all its language variants

vendor, ops

POST

Activates the template, making it available for sending notifications.

vendor, ops

Template Variant

View Template Variant operations
Capability
Method
Description
Access

List template variant

GET

Gets a list of template variants

vendor, ops

Create template variant

POST

Adds a new language variant to the template with subject and body content for the specified language.

vendor, ops

Get template variant

GET

Gets a template variant.

vendor, ops

Update template variant

PUT

Updates the subject and/or body content of the language variant. Only specific fields can be modified.

vendor, ops

Delete template variant

DELETE

Permanently removes the language variant from the template.

vendor, ops

Last updated

Was this helpful?