The HCSS connector needs a Client ID and a Client Secret to log in to HCSS before it can send any employee records. One of those two settings is completely missing from the saved connector configuration, so the platform cannot even attempt to log in. This is different from the setting being present but left blank. A blank value does not trigger this message. It lets the login attempt go through to HCSS, where it fails and produces a separate authentication error instead.
Messages in this article
| Message text | Direction | Occurs when | Outcome | Fix |
|---|---|---|---|---|
| HCSS Provider could not read the configuration setting '[configuration setting name]'. | Write | The named configuration setting has no row at all in the connector's saved configuration. Fires during login, before any employee is sent. | Sync stopped. No employees were written for this run. | Open the HCSS connector configuration and save a value for the named setting. |
Configuration setting names that can appear in this message
- Client ID
- Client Secret
Confirming the Error
- Click "Sync History" and open the sync record with the sync error from the Arcoro sync history screen.
- Find the step for the HCSS connector.
- Look at the run-level result rather than an individual employee row. Because this happens before any employee is processed, it shows up as a Failure for the run, not as an Errors count on an employee.
- Confirm the Added, Updated, and Unchanged counts for the Employees entity are all zero. That confirms the sync stopped at login and never reached any employee records.
- Open the Failure detail and match on the fixed part of the sentence, "HCSS Provider could not read the configuration setting", not on the setting name in quotes.
- Note which setting name appears in quotes: Client ID or Client Secret. That is the one missing from the connector configuration.
Resolving the Error
- Confirm from the sync log which setting is missing: Client ID or Client Secret.
- Open the connector configuration for the HCSS connector.
- Enter a valid value for the missing setting. Both values are credentials issued by HCSS.
- Save the connector configuration.
- Run the sync again.
- Confirm the fix worked by checking that the run no longer shows a Failure at login and that the Employees entity now shows Added, Updated, or Unchanged counts instead of all zeros.
When to Escalate
If any of the following occur, you may need to reach out to Arcoro support for additional assistance.
- Both settings are already saved with values in the connector configuration, but this exact message still appears. That does not match the documented trigger for this message and needs investigation.