Notification

In-built site notifications can be created in the following cases (there is an API notification type in brackets):

When someone registers the user to a training (USER_REGISTERED_TO_TRAINING);
One month before a certification expiration (ONE_MONTH_CERT_EXPIRATION);
When a certification has expired (CERT_EXPIRED);
When a user completes a training (TRAINING_COMPLETED);
When a new badge is earned (BADGE_EARNED);
For all community members (except the post author) when a new post is added (if the related setting is enabled for the community) (NEW_COMMUNITY_POST);
When someone added a comment on the user’s post (POST_COMMENTED);
When someone liked the user’s post or comment (POST_LIKED);
When a new connection invitation is created (NEW_USER_INVITATION);
When a user’s connection invitation is accepted (USER_INVITATION_ACCEPTED);
When a new challenge opens (NEW_CHALLENGE_STARTED);
Every 5 days when an available challenge is in progress, and a user did not complete it yet (ONGOING_CHALLENGE_NOT_COMPLETED);
When someone challenged a user for a battle (NEW_BATTLE);
When the user has won the battle (BATTLE_WIN);
When the user has lost the battle (BATTLE_LOST);
When the battle has finished with the status “draw”. (BATTLE_DRAW).

Notification API object

Notification object represents a single notification data:

Parameter	Type	Description
`id`	`ID`	Required. The notification ID.
`text`	`String`	Required. The notification text.
`type`	`NotificationType`	Required. The type of the notification that can be used for the results filtering.
`created`	`Int`	Required. A timestamp when the notification was created.
`status`	`NotificationStatus`	Required. The notification status (read/unread). Can be used to filter the query results.
`relatedEntity`	`NotificationRelatedEntity`	An entity that triggered the notification creation. Contains an API object that represents the entity.
`cta`	`[Cta]`	Contains the list of Call To Action objects available for the given notification.

The list of available CTAs can differ depending on the notification type.

Action ID	Description	Corresponding mutation/query
`ACCEPT_USER_INVITATION`	Allows to accept the user invitation related to the notification and add the invitation initiator to the current user’s network.	`acceptUserInvitation`
`CREATE_BATTLE_ATTEMPT`	Allows to create an attempt for the battle where the current API user has been selected as an opponent.	`createBattleAttempt`
`DECLINE_USER_INVITATION`	Allows to decline the user invitation related to the notification.	`declineUserInvitation`
`VIEW_BADGES_LIST`	View the list of earned badges.	`getBadges`
`VIEW_BATTLE_RESULTS`	View the related battle results.	`getBattle`
`VIEW_CHALLENGE`	View the related challenge.	`getChallenge`
`VIEW_POST`	Allows to view the post/comment related to the notification.	`getPost`
`VIEW_LP`	Allows to view the learning path related to the notification.	`getLearningPath`, example
`VIEW_USER_CONTEXT`	View the related user context.	`getUserContext`