subscriptions

Creates, updates, deletes, gets or lists a subscriptions resource.

Overview

Name	subscriptions
Type	Resource
Id	okta.users.subscriptions

Fields

The following fields are returned by SELECT queries:

list_subscriptions_user

Name	Datatype	Description
_links	object	Discoverable resources related to the subscription
channels	array	An array of sources send notifications to users. > Note: Currently, Okta only allows email channels.
notificationType	string	The type of notification
status	string	The status of the subscription

get_subscriptions_notification_type_user

Name	Datatype	Description
_links	object	Discoverable resources related to the subscription
channels	array	An array of sources send notifications to users. > Note: Currently, Okta only allows email channels.
notificationType	string	The type of notification
status	string	The status of the subscription

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_subscriptions_user	select	userId, subdomain		Lists all subscriptions available to a specified user. Returns an AccessDeniedException message if requests are made for another user.
get_subscriptions_notification_type_user	select	userId, notificationType, subdomain		Retrieves a subscription by notificationType for a specified user. Returns an AccessDeniedException message if requests are made for another user.
subscribe_by_notification_type_user	exec	userId, notificationType, subdomain		Subscribes the current user to a specified notification type. Returns an AccessDeniedException message if requests are made for another user.
unsubscribe_by_notification_type_user	exec	userId, notificationType, subdomain		Unsubscribes the current user from a specified notification type. Returns an AccessDeniedException message if requests are made for another user.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
notificationType	string
subdomain	string	The domain of your organization. This can be a provided subdomain of an official okta domain (okta.com, oktapreview.com, etc) or one of your configured custom domains. (default: my-org)
userId	string

SELECT examples

list_subscriptions_user

Lists all subscriptions available to a specified user. Returns an AccessDeniedException message if requests are made for another user.

SELECT
_links,
channels,
notificationType,
status
FROM okta.users.subscriptions
WHERE userId = '{{ userId }}' -- required
AND subdomain = '{{ subdomain }}' -- required;

get_subscriptions_notification_type_user

Retrieves a subscription by notificationType for a specified user. Returns an AccessDeniedException message if requests are made for another user.

SELECT
_links,
channels,
notificationType,
status
FROM okta.users.subscriptions
WHERE userId = '{{ userId }}' -- required
AND notificationType = '{{ notificationType }}' -- required
AND subdomain = '{{ subdomain }}' -- required;

Lifecycle Methods

subscribe_by_notification_type_user

Subscribes the current user to a specified notification type. Returns an AccessDeniedException message if requests are made for another user.

EXEC okta.users.subscriptions.subscribe_by_notification_type_user 
@userId='{{ userId }}' --required, 
@notificationType='{{ notificationType }}' --required, 
@subdomain='{{ subdomain }}' --required;

unsubscribe_by_notification_type_user

Unsubscribes the current user from a specified notification type. Returns an AccessDeniedException message if requests are made for another user.

EXEC okta.users.subscriptions.unsubscribe_by_notification_type_user 
@userId='{{ userId }}' --required, 
@notificationType='{{ notificationType }}' --required, 
@subdomain='{{ subdomain }}' --required;