Nursys Integration | Zoho Recruit

Nursys for Zoho Recruit

Verify nursing licenses faster and with greater confidence, right from Zoho Recruit. The Nursys integration connects your Recruit account with the official Nursys database, allowing you to initiate license verifications, track their status, and automatically populate key details without leaving your workflow.

Once installed, this integration adds a dedicated Nursys Licenses module and embeds verification directly into your candidate records. With just a click, you can validate credentials, reduce manual checks and ensure compliance, saving valuable time while improving hiring accuracy for healthcare roles.

Prerequisites

  • Before you install the Nursys for Zoho Recruit extension, make sure you have an account with Nursys. Visit their website and sign up as an institution

  • Once you have your account, you will need to contact Nursys Support at nursysenotify@ncsbn.org and request API access. They will then give share your API URL, which will be necesary to authorize the extension in Zoho Recruit.

 Installing the Nursys integration 

  • Go to the Marketplace tab and search Nursys for Zoho Recruit. Click Install.

  • Agree to the Terms of Service and Privacy Declaration.

  • Select which users you wish to install the extension for. You can choose from the following options:

    • All users

    • Admins only

    • Specific Profiles

  • Click Authorize for both cases and log in to your Nursys account to complete the installation process.
     

    • Connection for Zoho Recruit will ask you to allow permissions for the Recruit-end of the extension. Click Connect.

    • Likewise, the second Authorize button will ask you input your Nursys API credentials. Enter them and click Connect.

    • Lastly, enter the Nursys API URL in the pop-up that is displayed and click Save.

  • Once authorised, the extension will then be ready to use in your account. This will also add a new module named Nursys Licenses (with relevant fields) and a custom button named Verify License via Nursys for the Candidates module.

    • A new lookup called Related Nursys Licenses will be added to your Candidates module layout.

 

Verifying Licenses via Nursys

Notes

Important Note:

  • Before you initiate a verification for a candidate, please ensure that you added their license details in the License tabular field of the candidate record.

  • You can add more fields as columns in the lookup section such as the License Status, State, Expiration Date, and more for easy access and viewing.

  • Go the the candidate and click the Verify License via Nursys button.

  • The verification will then be initiated in Nursys and might take up to 45 mins to complete.

  • Once the verification process is completed, you will see the result in the Nursys Status field on the Nursys License record. This can be found under the Related List section of the candidate record for easier access.

  • If the verification is successful, the States Allowed to Practice and Jurisdiction fields will be populated automatically.

  • If there is an error or the verification fails, then the Nursys Error field will be updated with the Error Code.

    • If you require assistance, reach out to us at support@zohorecruit.com and make sure to include the error code in your email.   

 Errors  FAQs

Scenario

Error / Response

Cause

Resolution

Nursys domain not configured

Kindly configure your Nursys domain under Setup > Marketplace > Installed > Nursys for Zoho Recruit.

Nursys API domain is missing in extension settings.

Configure the correct Nursys domain in extension settings.

Required fields missing

Please ensure the following fields are filled

Mandatory candidate details are missing.

Fill all required fields such as LastFourSSN, Year of Birth, License Type, and License Jurisdiction.

Authentication failure

AUTHENTICATION ERROR: The following information is missing or incorrect: Invalid credentials

Invalid Nursys API credentials.

Verify and update API credentials in extension settings.

Invalid NCSBN ID

Invalid or missing NCSBN id

Missing or incorrect NCSBN ID.

Update the record with a valid NCSBN ID.

Request incomplete

The manage nurse list request has not completed

Nursys is still processing the request.

Wait and retry after some time.

License lookup failed

Unable to locate license in Nursys

License details do not match Nursys records.

Verify the candidate’s license details and retry.

Generic custom function error

We encountered an error while processing your request. Kindly contact support@zohorecruit.com with your error code for assistance.

Unexpected custom function execution issue.

Contact Zoho Recruit support with the error code.

Unhandled generic error

We were unable to process your request. Please try again after sometime or contact support@zohorecruit.com if the issue persists.

Temporary or unknown issue.

Retry later or contact support if the issue persists.

Successful execution

Candidate added to nurse list in Nursys. Verification might take a while, please check the Nursys Status and States Authorized to Practice fields for updates.

Candidate successfully added for verification.

Monitor the Nursys Status and States Authorized to Practice fields for updates.