Skip to main content
If Finch ever loses a connection with an employer’s provider system, we will return a 401 Unauthorized HTTP status code with a finch_code of reauthenticate_user (see Finch API errors). 
{
  "code": 401,
  "name": "authentication_error",
  "finch_code": "reauthenticate_user",
  "message": "Please reauthenticate user"
}
If an access token is returning this error, follow the reauthentication process to reconnect the employer. For multi-entity connections, if some entities require re-authentication while others remain connected, developers can continue retrieving data for the entities that are still connected. Employers using a multi-entity payroll system may add additional entities during reauthentication. However, entities that are already connected cannot be removed through the Finch reauthentication flow. If removal of an entity is required, disconnect the connection and provide a new Finch Connect link so the employer can update their entity selection.