Workday connector field reference

To successfully sync your data with the Teamwork Graph for use in Talent, you must format your Workday reports according to the specifications in the Workday connector setup guide.

This reference details the fields that are required and optional for use in the organizations, positions, and workers Workday reports.

Organization fields

The organizations report defines reporting and managerial hierarchy.

Required organization fields

Workday connector field	Type	Description
createdAt	ISO 8601 timestamp	Example: `2023-06-09T00:54:04.016-07:00`
isActive	Number	`isActive=1` for active organizations `isActive=0` for inactive organizations
managerPosition	String	Required when the `organizationId`’s manager assignment is associated with at least one `positionId`from the Positions report Not required when the `organizationId`’s manager assignment is not associated with any `positionId`. This is an unmanaged and empty organization.
organizationId	String	Must be unique per dataset
organizationName	String	Name of the organization, department, or team
superiorOrganizationId	String	Required for all except the top-most organization to indicate org hierarchy Must match an existing `organizationId` with `isActive` set to `1`

Optional organization fields

Workday connector field	Type	Description
inactiveDate	ISO 8601 date	Example: `2023-06-09` Only used if `isActive` is set to `0` Date must be within the past 30 days to trigger data deletion
lastUpdated	ISO 8601 timestamp	Example: `2023-06-09T00:54:04.016-07:00` Timestamp of last update

Workday connector field

Type

Description

inactiveDate

ISO 8601 date

Example: 2023-06-09

Only used if isActive is set to 0
Date must be within the past 30 days to trigger data deletion

lastUpdated

ISO 8601 timestamp

Example: 2023-06-09T00:54:04.016-07:00

Timestamp of last update

Position fields

The positions report defines roles within your organization and their staffing status.

Required position fields

Workday connector field	Type	Description
createdAt	ISO 8601 timestamp	Example: `2023-06-09T00:54:04.016-07:00`
isFilled	Number	`isFilled=1` for filled positions `isFilled=0` for unfilled positions Unfilled positions include open or frozen `staffingStatus`
positionId	String	Unique identifier
supervisoryOrganizationId	String	Must match an existing `organizationId` from the Organizations report with `isActive` set to `1`
workerId	String	Required when `isFilled` is set to `1` Must match an existing `workerId` from the Workers report with `isActive` set to `1`

Optional position fields

The externalPositionKey field is recommended to provide human-readable titles for positions, ensuring clear position context in Talent.

Workday connector field	Type	Description
businessTitle	String	Recommended to ensure displayed position names provide relevant context Human-readable position title shown in Talent
country	String	Country where the position is located
employmentType	Enum	Values: `Employee`, `Contingent`, or `Contractor`
externalPositionKey	String	Optional human-readable identifier, displayed and searchable in Talent
jobFamily	String	Internal job family classification
level	String	Job level or grade
lastUpdated	ISO 8601 timestamp	Example: `2023-06-09T00:54:04.016-07:00` Timestamp of last update
positionClosedDate	ISO 8601 date	Example: `2023-06-09` Only used if `staffingStatus` is `Closed` Date must be within the past 30 days to trigger data deletion
positionDescription	String	Longer description or summary of the role
staffingStatus	String	Values: `Filled`, `Unfilled`, `Open`, `Closed`, or `Frozen` Closed positions are not processed into Talent
timezone	String	Local timezone for the position

Worker fields

The workers report contains information about people in your organization.

Required worker fields

Workday connector field	Type	Description
createdAt	ISO 8601 timestamp	Example: `2023-06-09T00:54:04.016-07:00`
isActive	Number	`isActive=1` for active workers `isActive=0` for inactive workers
employeeName	String	Worker full name
workerId	String	Must be unique

Optional worker fields

The employeeEmailAddresses field is recommended to ensure data connects across the Atlassian Teamwork Graph, providing value in Talent and other apps.

Workday connector field	Type	Description
country	String	Country of residence
employeeEmailAddresses	String	Highly recommended to unlock features in Talent. An email address connects a worker to the Atlassian Teamwork Graph. Must be a valid email address, and unique across the dataset
hireDate	ISO 8601 date	Example: `2023-06-09`
jobFamily	String	Internal job family classification
lastUpdated	ISO 8601 timestamp	Example: `2023-06-09T00:54:04.016-07:00` Timestamp of last update
level	String	Job level or grade
localTimeZone	String	Local timezone for the worker
terminationDate	ISO 8601 date	Example: `2023-06-09` Only used if `isActive` is set to `0` Must be within the past 30 days to trigger data deletion
title	String	Worker professional title
workerUrl	String	Should contain a URL value

Was this helpful?

It wasn't accurateIt wasn't clearIt wasn't relevant

Still need help?

The Atlassian Community is here for you.

Ask the Community