Skip to content
Essentiq

Integrations

Troubleshooting

Teamtailor connection error messages

What the error messages mean when you connect or use Teamtailor in Essentiq, for example a key that doesn't work or lacks Admin scope.

Updated 2 min read

Most Teamtailor errors come down to the API key: the wrong key, the wrong region or the wrong scope. Find the message you see under Settings → Integrations or in the project, and follow the steps. Read Connect Teamtailor for the full setup.

"The key doesn't work. Check it and the region."

  1. Check that you copied the whole key. It starts with tt_api_.
  2. Check the Region: Europe, North America or Australia. Most Swedish companies are in Europe.
  3. Was the key deleted in Teamtailor? Create a new one under Settings → Integrations → API keys in Teamtailor.
  4. Click Test and connect again.

"The key lacks Admin scope. Create one with Admin and Read/Write."

You can't change the scope of an existing key.

  1. In Teamtailor go to Settings → Integrations → API keys and click + New API key.
  2. Choose Admin and Read/Write.
  3. Paste the new key in Essentiq and click Test and connect.

"Teamtailor isn't answering right now. Try again shortly."

Teamtailor can't be reached at the moment. Nothing has changed. Wait a few minutes and try again.

"Teamtailor is part of PRO."

The Teamtailor connection is part of Pro. Upgrade under Settings → Billing. This also applies to anyone using a shared connection.

"Teamtailor isn't connected."

The connection has been removed, by you or by the colleague who shared it. Connect Teamtailor again with your own key, or ask your colleague to share the connection again.

"Only whoever connected Teamtailor can do this."

You are using a shared connection. Only the person who connected Teamtailor can sync, change the sharing, change Send automatically when someone replies positively or disconnect.

"No Essentiq user with that e-mail."

You tried to share the connection with an address that has no Essentiq account. Check the spelling, or ask your colleague to create an account with that address first.

"Last error: …" or "Teamtailor: error" on a candidate

Something went wrong when a candidate was sent or when Essentiq synced. Click Sync now under Settings → Integrations. If the error stays, check that the key still exists in Teamtailor and has Admin scope. Then send the candidate again with To Teamtailor in the project's Favorites.

"No Teamtailor user matches your e-mail, so no notes are written."

Candidates are still sent, but without a note about the conversation. Add a Teamtailor user with the same email address you sign in to Essentiq with if you want the notes.

Common questions

Why doesn't my Teamtailor key work?

The key or the region is wrong, or the key lacks Admin scope and Read/Write. Create a new key in Teamtailor under Settings → Integrations → API keys and choose the right region.

Which region should I choose?

Most Swedish companies are in Europe. If unsure, try Europe first.

Why are no notes written in Teamtailor?

No Teamtailor user has the same email address as your Essentiq account. Candidates are still sent, without a note.

Was this article helpful?