Customizing notifications using the API

About this task

Application developers can use the API operations to customize notifications.

You can maintain different content for each template, delivery-method, and locale combination. When sending a notification, the system uses the language closest to the user’s locale, as configured on the user resource. Although adding multiple contents per template and delivery-method (distinguished by locale) is not currently supported in the PingOne admin console, you can add it through the API and then view and edit using the UI.

Steps

Use the access token generated through the worker app and the following POST operation:

POST https://api.pingone.com/v1/environments/{{envId}}/templates/{{templateName}}/contents

The templateName can be device_pairing, strong_authentication, or transaction.

Example:

POST https://api.pingone.com/v1/environments/{{envId}}/templates/{{templateName}}/contents
{
    "locale":"fr",
    "subject":"OTP pour ${user.username}",
    "body":"${user.username}, votre OTP: ${otp}",
    "deliveryMethod":"Email"
}

For details, see POST: CREATE Email Content and POST: CREATE Text Message Content in the API reference.

Next steps

Configure transaction approval