Finch Integration

DayZero integrates with Finch to sync payroll and HRIS data from providers like Gusto, ADP, Rippling, and others.

Connect Finch

Step 1: Get the connect URL

bash

curl "https://api.ondayzero.com/api/v1/finch/connect-url" \
  -H "Authorization: Bearer dz_your_token_here" \
  -H "x-business-id: YOUR_BUSINESS_ID"

Requires admin permission. Returns a Finch Connect authorization URL.

Step 2: Complete OAuth

Redirect the user to the connect URL. After authorization, Finch redirects back to your callback URL with a code parameter.

Step 3: Check status

bash

curl "https://api.ondayzero.com/api/v1/finch/status" \
  -H "Authorization: Bearer dz_your_token_here" \
  -H "x-business-id: YOUR_BUSINESS_ID"

Sync Data

Trigger a manual sync of payroll data:

bash

curl -X POST "https://api.ondayzero.com/api/v1/finch/sync" \
  -H "Authorization: Bearer dz_your_token_here" \
  -H "x-business-id: YOUR_BUSINESS_ID"

View Data

Company Info

bash

curl "https://api.ondayzero.com/api/v1/finch/company" \
  -H "Authorization: Bearer dz_your_token_here" \
  -H "x-business-id: YOUR_BUSINESS_ID"

Employee Directory

bash

curl "https://api.ondayzero.com/api/v1/finch/directory" \
  -H "Authorization: Bearer dz_your_token_here" \
  -H "x-business-id: YOUR_BUSINESS_ID"

Payroll Payments

bash

curl "https://api.ondayzero.com/api/v1/finch/payments?start_date=2026-01-01&end_date=2026-03-31" \
  -H "Authorization: Bearer dz_your_token_here" \
  -H "x-business-id: YOUR_BUSINESS_ID"

Pay Statements

bash

curl -X POST "https://api.ondayzero.com/api/v1/finch/pay-statements" \
  -H "Authorization: Bearer dz_your_token_here" \
  -H "x-business-id: YOUR_BUSINESS_ID" \
  -H "Content-Type: application/json" \
  -d '{"payment_ids": ["PAYMENT_ID_1", "PAYMENT_ID_2"]}'

Disconnect

bash

curl -X DELETE "https://api.ondayzero.com/api/v1/finch/disconnect" \
  -H "Authorization: Bearer dz_your_token_here" \
  -H "x-business-id: YOUR_BUSINESS_ID"