Troubleshoot

Fix common Ironclad integration errors

This page lists common errors and known issues encountered while integrating Ironclad with Zluri, and instructions on how to fix them.

If your issue isn’t mentioned here, feel free to submit a ticket or contact us directly at [email protected].

ICD-100-A: The Client ID and Client Secret used are invalid. Please ensure the right Client ID and Client Secret are used.

This error occurs when attempting to connect Ironclad to Zluri with an incorrect Client ID or Client Secret. To fix this:

  • Carefully follow the instructions to obtain the Ironclad Client ID and Secret.
  • Copy the Client ID and Client Secret exactly as provided in Ironclad, ensuring there are no missing or extra characters.

Try connecting Ironclad to Zluri again.

ICD-100-B: The Client ID and Client Secret used earlier have expired or been removed. Use a new Client ID and Client Secret to reconnect the integration.

This error occurs if the Client ID and Client Secret used to connect Ironclad to Zluri are no longer valid.

To resolve this, generate a new Client ID and Secret in Ironclad and update the credentials in Zluri before reconnecting the integration.

ICD-101-A: The Application you created in Ironclad does not have sufficient permissions to connect the integration. Please ensure the Application has the right permissions before reconnecting the integration.

This error occurs when the Ironclad application does not have the necessary permissions to connect to Zluri. To resolve this:

Reconnect to Zluri after configuring the permissions.

ICD-101-B: The permissions associated with the Application you created in Ironclad for connecting this integration are revoked. Please ensure that the Application has the right permissions before reconnecting the integration.

This error occurs when the previously assigned permissions for the Ironclad application have been revoked. To fix this:

  • Check if the required scopes are still enabled in Ironclad.
  • Reassign the necessary scopes, especially scim.users.readUsers, to the application.

Update the permissions and reconnect to Zluri.

ICD-102-A: The Application you created in Ironclad does not have sufficient permissions to connect the integration. Please ensure the Application has the right permissions to access users before reconnecting the integration.

This error occurs if the application in Ironclad does not have access to user data. To resolve this:

Reconnect to Zluri after enabling the necessary scope.

ICD-102-B: The permissions associated with the Application you created in Ironclad for connecting this integration are revoked. Please ensure that the Application has the right permissions to access users before reconnecting the integration.

This error occurs when user-related permissions were previously granted but have been revoked. To fix this:

  • Re-enable the scim.users.readUsers scope in Ironclad.
  • Verify that the application has access to user data.

Restore the permissions and reconnect to Zluri.

ICD-103-A: The Application you created in Ironclad does not have sufficient permissions to connect the integration. Please ensure the Application has the right permissions to access workflows before reconnecting the integration.

This error occurs if the application does not have access to workflow data. To resolve this:

  • Enable at least one of the following optional scopes in Ironclad:
    • public.workflows.readParticipants (for accessing the list of workflow participants)
    • public.workflows.readWorkflows (for accessing workflows)
  • Follow the steps to set up permissions in Ironclad.

Update the permissions and reconnect to Zluri.

ICD-103-B: The permissions associated with the Application you created in Ironclad for connecting this integration are revoked. Please ensure that the Application has the right permissions to access workflows before reconnecting the integration.

This error occurs when previously granted workflow-related permissions have been revoked. To fix this:

  • Check if public.workflows.readParticipants and public.workflows.readWorkflows are still enabled.
  • Reassign these permissions in Ironclad if necessary.

Restore the permissions and reconnect to Zluri.

ICD-104-A: The Application you created in Ironclad does not have sufficient permissions to connect the integration. Please ensure the Application has the right permissions to access records before reconnecting the integration.

This error occurs when the application lacks the necessary permissions to access records. To resolve this:

  • Enable at least one of the following optional scopes in Ironclad:
    • public.records.readRecords (for accessing records in the company)
    • public.records.readAttachments (for accessing attachments associated with specific records)
  • Follow the steps to set up permissions in Ironclad.

Reconnect to Zluri after enabling the necessary scopes.

ICD-104-B: The permissions associated with the Application you created in Ironclad for connecting this integration are revoked. Please ensure that the Application has the right permissions to access records before reconnecting the integration.

This error occurs when record-related permissions were previously granted but have been revoked. To fix this:

  • Check if public.records.readRecords and public.records.readAttachments are still enabled in Ironclad.
  • If permissions were removed, reassign them and save the changes.

Update the permissions and reconnect to Zluri.