Skip to content

REST API: iOS categories: Create

This endpoint creates a notification iOS categories for a specific application.

Categories define the type of notification and determine which predefined actions will be available to the user. They allow the mobile app to attach specific buttons and behaviors to notifications based on a category identifier.

POST API url -> /v1/notifications/ios-categories

Body Parameters

The following body parameters are possible:

Field Type Description Required
appId String Application id
name String Identifier of category
description Description for internal use Description for internal use

The name field specifies the iOS notification category identifier. It determines which set of action buttons will be displayed on the notification.

This name must exactly match a category identifier that is already defined in the mobile app using UNNotificationCategory, as required by Apple Inc. The server only sends the category name - the app is responsible for registering the category and its actions.

See the APNS UNNotificationCategory

Response Examples

Returns category id or error message

inc_zEntrV6ZeWXDa
Error message