Authorize an integration partner for an employee

Creates an employee consent record that authorizes (or revokes authorization for) an integration partner to access the employee's payroll data.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

This endpoint is used to manage the employee-level authorization lifecycle for integration partners such as earned wage access (EWA) providers.

🚧

Access restrictions

This endpoint is currently only callable by integration partners using their own OAuth credentials. Support for platform API keys to call this endpoint directly is planned.

Consent Titles

The consent_title field determines the type of consent being recorded:

ValueDescription
INTEGRATEDAuthorizes the integration partner to access the employee's payroll data. Sets has_consented to true.
DISCONNECTEDRevokes the employee's consent. The integration partner can no longer access the employee's data.
CLOSEDCloses the employee's account with the integration partner.

Behavior

  • Each call creates a new consent record (records are immutable for audit purposes).
  • The most recent consent record for a given employee + integration partner pair determines the current authorization state.
  • Returns HTTP 200 with no response body on success.
Path Params
string
required

The ID of the employee to authorize

Body Params
string
required

The email address of the employee providing consent.

string
required

The IP address of the employee at the time of consent.

string
enum
required
Allowed:
Responses
201

201 - Consent record created successfully. No response body is returned.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json