Knowledge Base: App-Specific Help > HHC API
What is 'Reset Act! Assignment' and how does it work?
Posted by Craig S, Last modified by Craig S on 24 October 2024 01:23 PM

Note:  This article pertains to Handheld Contact API subscribers only.  It does not affect API trial users.

Handheld Contact API supports multiple devices to sync with a single Handheld Contact API account.  For example if a customer has a phone and a tablet, both devices can utilize Handheld Contact API with the same login for HHC.  When a subscription is applied to this account, Handheld Contact will 'track' the Act! database name and Act! username.  When a secondary device attempts to use the same login and the Act! database name and Act! username match, then a login is successful.  However, if the Act! database name changes, or if there is a modification of the Act! user, then an error message can occur.  The error message reads:


"Unauthorized: API client trying to use subscription is already in use by another api client!"

Click here for an image of the error message.

 

This is letting the customer know that a change has occurred and the Act! database and/or Act! username do not match to what is on file so the login fails.

In order to correct this error message, a change will need to be made on the account from the Handheld Contact website.  Here are the steps needed:

  1. Go to: https://admin.handheldcontact.com/login/
  2. Log into Handheld Contact as the user who owns the subscription.  If you are a reseller or admin of Handheld Contact subscriptions, you need to login as that person.
  3. Click on 'Manage Subscriptions' from the left side of options.
  4. Under the section labeled "Subscriptions you own currently in use", search for the Handheld Contact API subscriber/license. 
  5. Under the 'Actions' column, click on the 'Reset Act! Assignment' link.
  6. A pop up will appear asking if you are sure you want to proceed.  Check the box and then choose 'Continue'.
  7. The side pop up will disappear.
  8. Proceed to the Handheld Contact API application on the mobile device in order to test the HHC login again.