We've completely reinvented our platform — new portals, new experience, same mission. See what's new

Connection Center: API Keys

Generate API credentials and push payroll data to Audit1 programmatically — on demand, no files.

Intermediate 6 min read Developers

What you'll learn

  1. Open the Connection Center
  2. Choose your API style
  3. Generate credentials
  4. Provider scope: global or per-insured

Before you start

1

Open the Connection Center

Navigate to the API Keys method.

  • Employers: Settings → Payroll → Connections → Create Connection → API Keys
  • Payroll companies: Settings → Connections Center → API Key → Get started
2

Choose Your API Style

New API v2.0 or the Legacy v1.0.

Pick New API v2.0 for all new integrations — modern REST with client_id + client_secret authentication. Legacy API v1.0 exists only for systems already built against the classic api.audit1.com portal.

Choose API style
New API v2.0 (recommended) vs Legacy API v1.0.
3

Generate Credentials

One click creates your client_id and client_secret.

Audit1 generates a client_id and client_secret. Push payroll reports to apiv2.audit1.com/api/v2/payroll/reports with the X-Client-ID and X-Client-Secret headers — JSON payloads, HMAC-SHA256 security.

Set up API v2.0 connection
Review the endpoint details, then click Generate API Credentials.
The secret is shown once. Store it in your secrets manager right away.
4

Provider Scope: Global or Per-Insured

One key for everything, or one per client.

Payroll companies choose between a Global API Key (one key pushes payroll for any of your clients) or a Per-Insured API Key (requests are scoped to that single insured).

Choose API key scope
Global API Key vs Per-Insured API Key.
Ready to code? Full request/response reference in the API docs.

Continue learning