Pardon the mess

You are viewing docs related to an older version of Sequin. We’re in the process of updating our provider-specific guides and will be done in a few weeks (February 2024). Please click here to view the latest version of the docs.

If you’re interested in Workday and want to learn more about what’s changing, send us a note.

Supported objects

Collection NameReadWrite
Absence Management
Accounts Payable
Benefit Partner
Budgets
Business Process
Common
Compensation
Connect
Contract Compliance
Core Accounting
Custom Object Data (multi-instance)
Custom Object Data (single-instance)
Customer Accounts
Expense
Fin Tax Public
Global Payroll
Help Case
Holiday
O Auth Client
Payroll
Performance Enablement
Person
Prism Analytics
Privacy
Procurement
Projects
Recruiting
Request
Revenue
Staffing
Student Academic Foundation
Student Core
Student Curriculum
Student Engagement
Student Finance
System Metrics
Talent Management
Time Tracking
Worktag
Wql

Setup & installation

In Sequin, click Add sync and select Workday. You can then authenticate Sequin to Workday by entering the following required fields into Sequin:

  • Hostname
  • Tenant ID
  • Username
  • Password
The hostname is the hostname of the Workday SOAP endpoints you want to use. You only need to enter the hostname, without https:// nor particular endpoint URL.

For example, if you want to use this SOAP endpoint: https://wd2-impl-services1.workday.com/ccx/service/your_company/Human_Resources/v40.1, enter wd2-impl-services1.workday.com. If you don’t have a hostname, enter wd2-impl-services1.workday.com.

You can find your tenant ID from your URL when you are logged into Workday. For example, if the URL is https://impl.workday.com/your_company/d/home.html, then your tenant ID is your_company.

The syncing process

We first backfill your database with all your Workday data. The time for the backfill depends on the size of your Workday account. Unless your Workday account has over a million records, the backfill should complete in under an hour. Smaller accounts complete in just a few minutes. We’ll email you when your backfill is complete and Sequin has loaded all your data into your database.

After the initial backfill, we’ll rely on Workday webhooks to monitor changes. We backstop webhooks with an occasional polling process to ensure we don’t miss any events. This means changes on Workday should propagate to your database in just a few seconds.

Learn more about [our syncing process]/syncs.

Read and write Workday data using SQL

You’ll connect to your database via Sequin’s Postgres Proxy, which lets you read from your synced tables as well as write to them. You can use any SQL client that works with Postgres.

Here’s an example of what your Workday tables might look like in your database:

db7hea89oah3tas=> \dt

                   List of relations
 Schema |           Name            | Type  |  Owner
--------+---------------------------+-------+----------
 public | _sync_cdc                 | table | sequin
 public | worker                    | table | sequin
 public | worket_event              | table | sequin
 public | worker_position           | table | sequin
(4 rows)

You’ll see all the Workday objects you selected when setting up your sync are now tables in your database. You’ll also see a _sync_cdc table which Sequin uses to manage your sync.

Here’s what it looks like to query the worker table:

select
    first_name,
    last_name,
    position,
    department,
    hire_date,
    employment_status
from
    worker
where
    id = '123456';

Which returns a row that looks like:

-[ RECORD 1 ]---+-----------------------------
first_name        | Paul
last_name         | Atreides
position          | Software Engineer
department        | Dune
hire_date         | 1980-01-01
employment_status | false

Writing back to Workday is as simple as writing a SQL query. For example, you can mark a user’s email as verified like this:

update worker
set employement_status = true
where id = '123456';

Sequin will write this change to both Workday and your database at the same time.

If a write to Workday fails, Sequin will roll back the write to your database. For example, if you try to update a user’s email to an invalid email address, you’ll receive a Postgres error:

update woker
set email = 'invalid-email'
where id = '123456';

ERROR: [Workday] invalid input syntax for type email: "invalid-email"

Next steps

Your Workday tables are now available as fully readable and writeable tables in your database. You can query for all your data using SQL, and mutate data thanks to Sequin’s Postgres Proxy. To build on this foundation, here are some next steps:

  • Setup your ORM to work with your synced tables.
  • Edit the Workday objects and properties you’re syncing at any time.
  • Create views on your Workday data to tailor your schema to your needs.
  • Invite your team to your Sequin account and start building!

If you need assistance setting up your sync, just send us a note. We’re around and eager to help.

Was this page helpful?