Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

NotificationAPI User Preferences API

Read and write per-user channel and opt-out preferences.

NotificationAPI User Preferences API is one of 7 APIs that NotificationAPI publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include User Preferences. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 2 operations across 2 paths, and defines 2 schemas. It is described by OpenAPI 3.0.3, at version 2.8.

Requests are made against 3 base URLs: https://api.notificationapi.com/{clientId}, https://api.eu.notificationapi.com/{clientId}, https://api.ca.notificationapi.com/{clientId}.

2 operations 2 paths 2 schemas 1 DELETE1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.8
Base URL
https://api.notificationapi.com/{clientId}
Authentication
HTTP Basic
Terms of Service
Resource Areas
1

Authentication & Security 1

NotificationAPI User Preferences API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

  • basicAuth — HTTP Basic authentication. For account-level calls the username is your clientId and the password is your clientSecret. Per-user calls (identify user, in-app i…

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 1 DELETE, 1 POST. Each is listed below with its method, path, parameters, and response codes.

User Preferences 2

Read and write per-user channel and opt-out preferences.

DELETE
/users/{userId}/preferences
Delete stored preferences for a user
deleteUserPreferences 3 params → 200
POST
/user_preferences/{userId}
Set user preferences
setUserPreferences 1 param body → 200

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed is UserPreference (4 properties). Each schema is shown below with its type and property counts.

UserPreference
object
4 properties 1 required
Channel
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

notificationapi-user-preferences-api-openapi.yml Raw ↑

Other APIs NotificationAPI publishes across the network.

NotificationAPI In-App Inbox API
NotificationAPI Logs API
NotificationAPI Notifications API
NotificationAPI Schedule API
NotificationAPI Send API
NotificationAPI Users API