Skip to main content
Server path: /workday-connect | Type: Application | PCID required: Yes

Tools

ToolDescription
workday_connect_get_messagetemplatesRetrieves a collection of message templates.
workday_connect_get_messagetemplates_by_idRetrieves a message template with the specific ID.
workday_connect_get_notificationtypesRetrieves a collection of notification types.
workday_connect_get_notificationtypes_by_idRetrieves a notification type.
workday_connect_get_values_audiencepromptgroup_audiencetypeRetrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Administer Audience, Administer Campaigns <b>Scope:</b> Learning Core, System
workday_connect_get_values_audiencepromptgroup_selectionRetrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Administer Audience, Administer Campaigns <b>Scope:</b> Learning Core, System
workday_connect_patch_messagetemplates_by_idPartially updates an existing message template instance.
workday_connect_post_messagetemplates<b>Secured by:</b> Set Up: Message Templates <b>Scope:</b> Learning Core, System
workday_connect_post_sendmessagesendMessage API
workday_connect_put_messagetemplates_by_idUpdates an existing message template instance.

workday_connect_get_messagetemplates

Retrieves a collection of message templates. Parameters:
ParameterTypeRequiredDefaultDescription
inactivebooleanNoinactive
limitintegerNoThe maximum number of objects in a single response. The default is 20. The maximum is 100.
namestringNoname
notificationTypestringNonotificationType
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.

workday_connect_get_messagetemplates_by_id

Retrieves a message template with the specific ID. Parameters:
ParameterTypeRequiredDefaultDescription
IDstringYesThe Workday ID of the resource.

workday_connect_get_notificationtypes

Retrieves a collection of notification types. Parameters:
ParameterTypeRequiredDefaultDescription
limitintegerNoThe maximum number of objects in a single response. The default is 20. The maximum is 100.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.

workday_connect_get_notificationtypes_by_id

Retrieves a notification type. Parameters:
ParameterTypeRequiredDefaultDescription
IDstringYesThe Workday ID of the resource.

workday_connect_get_values_audiencepromptgroup_audiencetype

Retrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Administer Audience, Administer Campaigns <b>Scope:</b> Learning Core, System Parameters:
ParameterTypeRequiredDefaultDescription
audienceTypeParmstringNoaudienceTypeParm
connectTypestringNoconnectType
limitintegerNoThe maximum number of objects in a single response. The default and maximum is 1000.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
searchstringNoA search string that matches display IDs. The search is case-insensitive and matches words that start with the given string.

workday_connect_get_values_audiencepromptgroup_selection

Retrieves instances that can be used as values for other endpoint parameters in this service. <b>Secured by:</b> Administer Audience, Administer Campaigns <b>Scope:</b> Learning Core, System Parameters:
ParameterTypeRequiredDefaultDescription
audienceTypeParmstringNoaudienceTypeParm
connectTypestringNoconnectType
limitintegerNoThe maximum number of objects in a single response. The default and maximum is 1000.
offsetintegerNoThe zero-based index of the first object in a response collection. The default is 0. Use offset with the limit parameter to control paging of a response collection. Example: If limit is 5 and offset is 9, the response returns a collection of 5 objects starting with the 10th object.
searchstringNoA search string that matches display IDs. The search is case-insensitive and matches words that start with the given string.

workday_connect_patch_messagetemplates_by_id

Partially updates an existing message template instance. Parameters:
ParameterTypeRequiredDefaultDescription
IDstringYesThe Workday ID of the resource.
createdByobjectNoMessage Template creator.
createdOnstringNoGives the date that the instance was originally created.
descriptorstringNoThe display name of the instance
emailDetailobjectNoEmail Configuration container for REST API.
idstringNoWorkday Id or Reference Id of the instance.
inactivebooleanNoIndicates template is active or has been disabled.
lastUpdatedstringNolastUpdated
lastUpdatedByobjectNoPerson who last updated the instance.
namestringYesMessage Template Name
notificationTypeobjectYesNotification Type indicates where the template can be used.
pushDetailobjectNoContainer for push notification data, used in REST API.
referenceIDstringNoThe Reference ID to use for lookups within our Workday Web Services. For ~supervisory organizations~, this is also the ‘Organization ID’
usageCountintegerNoCount of instances using this Message Template

workday_connect_post_messagetemplates

<b>Secured by:</b> Set Up: Message Templates <b>Scope:</b> Learning Core, System Parameters:
ParameterTypeRequiredDefaultDescription
createdByobjectNoMessage Template creator.
createdOnstringNoGives the date that the instance was originally created.
descriptorstringNoThe display name of the instance
emailDetailobjectNoEmail Configuration container for REST API.
idstringNoWorkday Id or Reference Id of the instance.
inactivebooleanNoIndicates template is active or has been disabled.
lastUpdatedstringNolastUpdated
lastUpdatedByobjectNoPerson who last updated the instance.
namestringYesMessage Template Name
notificationTypeobjectYesNotification Type indicates where the template can be used.
pushDetailobjectNoContainer for push notification data, used in REST API.
referenceIDstringNoThe Reference ID to use for lookups within our Workday Web Services. For ~supervisory organizations~, this is also the ‘Organization ID’
usageCountintegerNoCount of instances using this Message Template

workday_connect_post_sendmessage

sendMessage API Parameters:
ParameterTypeRequiredDefaultDescription
commIDobjectNoGroup Communication
emailDetailobjectNoEmail Configuration Data
messageTemplateobjectNoMessage Template used by Ad-hoc/Group Communications
notificationTypeobjectNoNotification Type indicates where the template can be used.
pushDetailobjectNoContainer for push notification data, used in REST API
recipientsobjectNoThis field is just used by REST framework to provide a container, there is no real data behind it.
senderOverrideobjectNoThis field affects the sender icon that will be displayed in the Workday Inbox.

workday_connect_put_messagetemplates_by_id

Updates an existing message template instance. Parameters:
ParameterTypeRequiredDefaultDescription
IDstringYesThe Workday ID of the resource.
createdByobjectNoMessage Template creator.
createdOnstringNoGives the date that the instance was originally created.
descriptorstringNoThe display name of the instance
emailDetailobjectNoEmail Configuration container for REST API.
idstringNoWorkday Id or Reference Id of the instance.
inactivebooleanNoIndicates template is active or has been disabled.
lastUpdatedstringNolastUpdated
lastUpdatedByobjectNoPerson who last updated the instance.
namestringYesMessage Template Name
notificationTypeobjectYesNotification Type indicates where the template can be used.
pushDetailobjectNoContainer for push notification data, used in REST API.
referenceIDstringNoThe Reference ID to use for lookups within our Workday Web Services. For ~supervisory organizations~, this is also the ‘Organization ID’
usageCountintegerNoCount of instances using this Message Template