Search Work Emails

Retrieve the work email addresses for a specific worker ID in Workday.

Options

Field Definition Type Required

Result Set

Choose a method to filter search results:

  • First Matching Record: Returns the first record that matches.

  • First 100 Matching Records: Returns the first 100 matching records.

  • Stream Matching Records: Passes all matching records from your parent flow to a helper flow.

    Selecting this option adds a Streaming input section to the card where you can select a helper flow for streaming and add custom extensible fields.

Dropdown

TRUE

Input

Field Definition Type Required

Search Criteria

Person ID

Unique identifier of the person.

Text

TRUE

Primary Only

If True, the search returns only the person's primary email addresses.

True/False

FALSE

Public Only

If True, the search returns only the person's public email addresses.

True/False

FALSE

Streaming

Flow

Click Choose Flow to browse and select a helper flow where the search results will be streamed, then click Choose to confirm.

Optionally, click the empty field under Click or drop here to create and add custom extensible fields that pass data to the helper flow. These fields are added as key/value pairs under the State output object in the helper flow.

This field appears when you select Stream Matching Records from the Result Set option.

Flow

TRUE

Record Limit

Specify the number of records to stream.

  • When the Record Limit field is set to 0, the stream returns no records.

  • When the Record Limit field is set to greater than 0, the stream returns up to the maximum number specified.

  • When the Record Limit field is empty, null, or not selected, the stream returns all records.

  • The default value is 500000.

  • The valid range is from 0 to 500000.

This field appears when you select Stream Matching Records from the Result Set option.

Number

FALSE

Output

Field Definition Type

Result

Raw Output

The raw output that Workday returns.

Object

Email ID

Unique identifier of the email.

Text

Email Address

The email address.

Text

Email Comment

Comment associated with the email.

Text

Usage

Object

Usage Type

The usage type for a given communication method.

Object

Usage Type ID

The unique identifier of the usage type.

Text

Usage Type Descriptor

A preview of the item, as described in the Workday object.

Text

Primary

True if the communication method has any primary usage type.

True/False

Public

True if the communication method is public.

If no results are returned, the communication method is private.

True/False

Used For

Usage behaviors for the communication method, such as mailing, billing, or shipping.

List of Objects

Used For ID

Unique identifier for the Used For resource.

Text

Used For Descriptor

A preview of the item, as described in the Workday object.

Text

Emails

Each object contains the details for an individual work email.

This field appears when you select First 100 Matching Records from the Result Set option.

List of Objects

Records Streamed

Number of records streamed in a streaming flow.

This field appears when you select Stream Matching Records from the Result Set option.

Number

Related topics

Workday connector

Cards in flows

Workday Staffing API