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:

Value	Description
`INTEGRATED`	Authorizes the integration partner to access the employee's payroll data. Sets `has_consented` to `true`.
`DISCONNECTED`	Revokes the employee's consent. The integration partner can no longer access the employee's data.
`CLOSED`	Closes 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 201 with no response body on success.
The ip_address field is optional but recommended for compliance tracking.