How do I set up the TempWorks integration?

Last updated: May 28, 2026

This walks you through connecting Onboarded to TempWorks — entering credentials, configuring field and document mappings, and running your first sync.

Before you start

  • You'll need your TempWorks Client ID, Client Secret, and ACR Values. Get these from your TempWorks account representative if you don't have them.

  • You need account-owner or admin permissions in Onboarded.

Steps

Step 1 — Enter credentials

  1. Navigate to Account Settings → Integrations and find TempWorks in the list.

  2. Click Configure. A side panel opens with a three-step wizard: Credentials, Configuration, and Sync Records.

  3. Enter your Client ID, Client Secret, and ACR Values.

ACR Values format
This field expects a space-separated pair: tenant:{your-tenant-name} pid:{your-policy-id} — for example, tenant:AcmeStaffing pid:4E7A875D-36AD-4F27-891A-A25E8F57FB90. Your TempWorks representative can confirm these values. A wrong format here is the most common reason credentials fail to save.

  1. Optional — Advanced settings. If your TempWorks environment uses non-default API URLs (staging, RC, or an on-prem setup), expand Advanced and enter the custom Authority API URL, Open API URL, and Webhook API URL. Leave these blank to use the standard TempWorks cloud environment.

  2. Click Save. Onboarded verifies the credentials against TempWorks before saving. You should see a success toast and the wizard advances to Configuration.

Step 2 — Configure field and document mappings

Field mappings tell Onboarded how TempWorks data maps to your Onboarded fact paths. Document mappings tell Onboarded which TempWorks document type to attach when it pushes a completed form.

  1. Add field mappings. Under Field Mappings, click New Mapping. For each mapping, choose the TempWorks entity type (Employee, Job Order, Customer, Employer, or Assignment), the specific TempWorks field, and the Onboarded field path it should populate. Repeat for each field you want synced.

  2. Add document mappings. Under Document Mappings, click New Mapping. Choose an Onboarded form and the TempWorks document type it should write to when the form is completed — for example, your I-9 form mapped to Federal I-9 in TempWorks. Repeat for each form you want to push documents for.

  3. Click Continue to advance to the sync step.

Step 3 — Run the initial sync

  1. Click Start sync. Onboarded begins pulling employees, customers, job orders, employers, and assignments from TempWorks into your account. The sync runs in the background — you can close the panel.

Sync time depends on dataset size. You can monitor progress on the Integrations → TempWorks page.

Verify

After saving credentials, the TempWorks card in Account Settings → Integrations shows as connected. Once the initial sync finishes, navigate to Integrations → TempWorks and confirm records appear in the table. A green Success status on sync records means data landed correctly.

If records show a red Failed status, the Error Message column identifies the field that didn't map. Check that the Onboarded field path in your field mapping is correct, then restart the sync.

Related