OAuth Script Reauthorisation / Client Secret Renewal Guide

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:

  1. Navigate to:
    • Settings > Folders
  1. Open the affected folder.
  2. Scroll to the Email section.
  3. The value shown in the Password field will be the name of the OAuth script being used by that folder.
  4. Use this script name to locate the correct script under:
    • Settings > More Tools > OAuth Scripts

Reauthorise the OAuth Script

  1. Navigate to:
    • Settings > More Tools > OAuth Scripts
  2. Open the affected OAuth script.
  3. Select Auth.
  1. 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.
  2. Select Save / OK.
  3. Test the affected functionality.

Create a New Client Secret (If Required)

If reauthorisation fails or the existing Client Secret has expired:

  1. In Microsoft Entra ID, navigate to:
    • App registrations
    • Select the relevant application.
    • Certificates & secrets.
  2. Select New client secret.
  3. Enter a description.
  4. Set the expiry to 24 months.
  5. Select Add.
  6. Copy the Client Secret Value immediately.
  7. Record the Client Secret expiry date for future reference.
  8. Update the Client Secret Value in the relevant OAuth script within Hoth.
  9. Select Save.

Reauthorise After Updating the Client Secret

  1. Navigate to:
    • Settings > More Tools > OAuth Scripts
  2. Open the affected OAuth script.
  3. Select Auth.
  4. Sign in using the account associated with the script.
  5. 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.

Maximize Your Organisation’s Impact

HOTH is committed to helping charities and non-profits achieve more with less by providing a powerful platform for IT and compliance management.

Asset 3@4x-8

Making service simple—smarter, faster, together.
Hoth empowers teams to deliver smarter services across IT, Customer Support, Facilities, Governance, and Enterprise Management. Our flexible, AI-supported platform streamlines operations, boosts collaboration, and ensures compliance—making it easy to support your people, processes, and priorities.

Follow Us

Email: info@houseonthehill.com
Sales: +44 161 520 0222
Support: +44 161 528 1259

 

Company Registration : 2790771.  Registered Office Address: 127 Stockport Road, Greater Manchester, UK, SK6 6AF  
(C) Copyright 2025. All Rights Reserved. House on the Hill. Designed and Developed by Kode88