If email processing or user synchronisation stops working, the OAuth script may need reauthorising, or the Client Secret used by the associated App Registration may have expired.
Common Symptoms
- Emails are received by the mailbox but are not being processed by Hoth.
- New tickets are not being created from incoming emails.
- User imports stop running.
- Users are no longer being created or updated.
- The sync date is no longer updating.
Identifying the Correct OAuth Script
If multiple OAuth scripts are configured for different mailboxes:
- Navigate to:
- Settings > Folders
- Open the affected folder.
- Scroll to the Email section.
- The value shown in the Password field will be the name of the OAuth script being used by that folder.
- Use this script name to locate the correct script under:
- Settings > More Tools > OAuth Scripts
Reauthorise the OAuth Script
- Navigate to:
- Settings > More Tools > OAuth Scripts
- Open the affected OAuth script.
- Select Auth.
- Sign in using the account associated with the script.
- For email processing, this is typically the mailbox account.
- For user synchronisation, an account with suitable Entra ID permissions may be required.
- Select Save / OK.
- Test the affected functionality.
Create a New Client Secret (If Required)
If reauthorisation fails or the existing Client Secret has expired:
- In Microsoft Entra ID, navigate to:
- App registrations
- Select the relevant application.
- Certificates & secrets.
- Select New client secret.
- Enter a description.
- Set the expiry to 24 months.
- Select Add.
- Copy the Client Secret Value immediately.
- Record the Client Secret expiry date for future reference.
- Update the Client Secret Value in the relevant OAuth script within Hoth.
- Select Save.
Reauthorise After Updating the Client Secret
- Navigate to:
- Settings > More Tools > OAuth Scripts
- Open the affected OAuth script.
- Select Auth.
- Sign in using the account associated with the script.
- Select Save / OK.
Validation
- Send a test email to the monitored mailbox.
- Confirm the email is processed successfully in Hoth.
- Run the user synchronisation.
- Confirm users are imported or updated successfully.
- Verify the sync date updates to the current date.
If the tests are successful, the OAuth configuration has been restored and normal operation should resume.