Employment Hero Payroll vs Everee

Employment Hero Payroll

Five public Swagger 2.0 files describe 660 to 821 operations per region, and any payroll user can generate an API key without a partner review. The key carries its user's whole access, no idempotency keys or API changelog were found, and the only official client is for .NET.

Everee

Everee's API tokens are created in the admin portal of each company instance, and payments wait for a payroll admin's approval unless auto-approval is arranged. The API has no preview or approval endpoint, no single OpenAPI file, no SDK and no changelog, and a company instance starts with a sales call.

Employment Hero Payroll

1. Send the API key as the Basic auth username with a blank password, for example curl -u {api_key}: https://api.yourpayroll.com.au/api/v2/user
2. Pick the Swagger file for the business's region (swagger-au.json, swagger-nz.json, swagger-uk.json, swagger-sg.json, swagger-my.json). Paths and models differ by region
3. Stay under 5 requests a second per key and IP address. A 429 answered our test with retry-after: 1
4. Page lists with $skip and $top (100 at most). Filter property names are capitalised, unlike the camelCase JSON
5. Read GET /api/v2/business/{businessId}/payrun/{payRunId}/warnings before POST .../finalise. Finalise can lodge with the tax office and publish pay slips in the same call

Everee

1. Send two headers on every call, authorization: basic <token> and x-everee-tenant-id. Base64-encode a token that starts with sk_ first.
2. Derive each payable's externalId from stable data, never a timestamp or UUID, so a retried create is rejected instead of paying twice.
3. For contractors, call POST /integration/v1/payables/payment-request after all payable items are sent and before admins approve. Without it contractors aren't paid.
4. Send hourly wages through the Timesheets API, not Payables, and assign workLocationId so tax is worked out for the right jurisdiction.
5. Don't expect the API to move money alone. Tell the user a payroll admin must approve in the portal unless auto-approval is enabled, and read Everee's terms on automated access first.