Skip to main content
Open Settings > API. It sits under Connections in the settings sidebar. Owners and Admins see this page. It comes with a hosted plan. Without one, you see Hosted hiring only and a link to View billing. The page has three tabs:

Keys

An API key lets your own scripts read and change hiring data over HTTP. See Authentication for what a key can call.

Create a key

1

Name the key

On the Keys tab, type a name in Key name. Pick one that says where the key is used.
2

Create it

Click Create key.
3

Copy the key

Copy this key opens. Click the copy button next to the key. This is the only time it is shown, so store it somewhere safe before you close the window.
If you lose a key, revoke it and create a new one. A company can have up to 20 keys.

The key list

Revoke a key

Click Revoke on the key’s row, then Revoke again to confirm. Anything using the key stops working right away.

Apps

The Apps tab lists AI apps, like Claude, ChatGPT, Cursor, or Codex, that someone on your team connected by signing in with Hotfix. To connect one, see Get started. As an Owner or Admin, you see every app connected to your company.

Disconnect an app

Click Disconnect on the app’s row, then Disconnect again to confirm. The app loses access right away. To use it again, someone has to sign in again.

Webhooks

A webhook sends hiring events to a URL you own as they happen. See Webhooks for what each delivery contains, how to check the signature, and how retries work.

Add a webhook

1

Start a new webhook

On the Webhooks tab, click New webhook.
2

Enter the URL

In Endpoint URL, enter the address that should get events. It must start with https://.
3

Pick events

Under Events, keep All events to get every event, including ones added later. Or uncheck it and pick the events you want.
4

Add it

Click Add webhook.
5

Copy the signing secret

Copy this signing secret opens. Click the copy button and give the secret to whoever runs the endpoint. This is the only time it is shown.
A company can have up to 10 webhooks. When you reach 10, New webhook is turned off.

Events you can pick

The webhook list

Hover the mark in Last delivery to see what it means:

Edit a webhook

Click a webhook’s row to open it. Change the Endpoint URL or the Events, then click Save. The signing secret stays the same.

Rotate the secret

Open the webhook and click Rotate secret. A new secret shows once. Copy it. Deliveries sign with the new secret right away, so update your endpoint at the same time.

Send a test event

Open the webhook and click Send test event. Hotfix sends a test event to the URL and tells you whether it was delivered, with the response code, or why it failed.

Recent deliveries

Open the webhook to see Recent deliveries, newest first, up to 20. Each line shows the mark, the event, how many tries it took when more than one, and when it was sent.

Remove a webhook

Open the webhook and click Remove, then Remove again to confirm. Hotfix stops sending to that URL right away.