Skip to main content

Expert Hire APIs

Two APIs. Pick the one that matches what you are doing.

Expert Hire publishes two separate APIs. They are different products with different keys, different URLs and different results. Pick one before you read anything else.

They are not interchangeable

The same words mean different things in each.

HiringPreparation
The personA candidate being assessed for a roleA learner practising
The resultA hiring signal you act onFeedback the learner acts on
Key prefixehs_sk_live_ / ehs_sk_test_ehp_sk_live_ / ehp_sk_test_
Base URLhiring-api.experthire.cloudprep-api.experthire.cloud

A key from one is rejected by the other. That is deliberate: the prefixes are namespaced so an integration cannot quietly point at the wrong product and produce results that look plausible and mean nothing.

Using both? They are independent integrations. Register separately, store the keys separately, and do not share a webhook endpoint between them.

What is the same

Both work the same way once you have picked one:

  1. Your server calls the API with a secret key.
  2. The candidate or learner opens a link, or your page embeds the session.
  3. Your webhook endpoint receives the result, so you are not polling.

Both have a sandbox that costs nothing, and both return a signed webhook you should verify on the raw body.