Teamtailor integration

Create Docue documents for your candidates directly from Teamtailor and follow their signing status on the candidate's profile.

With the Docue integration for Teamtailor, you can create documents such as employment contracts for your candidates without leaving Teamtailor. Docue fills in the candidate's details, sends the document for signing, and shows its status on the candidate's profile in Teamtailor.

How it works

  1. A recruiter starts Docue for a candidate in Teamtailor, or a Teamtailor automation does it, for example when the candidate moves to the hiring stage.
  2. Docue creates a document from the template you chose and fills in the candidate's first name, last name and email address.
  3. Docue sends the document for signing to the signees defined in the template.
  4. The candidate's profile in Teamtailor shows the document's status and a link to open it in Docue. The status updates automatically as the document moves forward.

The status on the candidate's profile is one of the following:

  • Draft – action required: the document was created but not sent. Open it in Docue, check it and send it for signing.
  • Awaiting signatures: the document has been sent and is waiting for signatures.
  • Signed: everyone has signed the document.
  • Cancelled: signing was cancelled in Docue.
  • Deleted in Docue: the document was deleted in Docue.

Before you start

You need:

  • A Docue workspace with API access. Contact Docue customer support to get an API key for your workspace.
  • A template made for the integration. The template is tailored for your company and for use with Teamtailor. Contact Docue customer support and we will set up the template with you.
  • Docue accounts for your recruiters. The document is owned by the Docue user whose email address matches the Teamtailor user who started it. Recruiters need a Docue login to open the document from Teamtailor.

Set up the integration

  1. In Teamtailor, go to Settings and open the Marketplace under Integrations.
  2. Find Docue and activate it.
  3. Enter your Docue API key.
  4. Fill in the optional settings if you want to (see below), and save.

Optional settings

  • Folder: the Docue folder where new documents are saved. Enter the folder ID, which you can find at the end of the folder's address when you open it in Docue (after /documents/f/). If you leave this empty, documents are saved in your workspace's main folder.
  • Sender name: the name candidates see in the signing invitation. If you leave this empty, your Docue workspace name is used.
  • Default template: the ID of the Docue template you always want to use. When this is set, recruiters don't need to choose a template each time. Our customer support can tell you the template ID.
  • Document name: the name the document gets in your Docue Drive. You can use these placeholders:
    • {document_title}: the template's name
    • {tt_first_name}: the candidate's first name
    • {tt_last_name}: the candidate's last name

    For example, {document_title}, {tt_first_name} {tt_last_name} gives a name like "Employment contract, Anna Virtanen". If you leave this empty, the document gets the template's name. This setting changes only the name in Docue Drive, not the name signees see.

Create a document for a candidate

You can start Docue for one candidate at a time from their profile, or add Docue as a trigger to a job stage so it runs automatically when a candidate moves to that stage.

In both cases, choose:

  • Docue template: the template to use. This option is hidden if you have set a default template.
  • Signing method: Strong electronic identification (for example, with online banking credentials) or Drawn signature.

Docue then creates the document and sends it for signing. After a moment, the candidate's profile shows the document and its status.

If you saved a Docue trigger before the signing method option was available, open the trigger, choose a signing method and save it again. Otherwise the documents stay as drafts.

When a document stays as a draft

If the candidate's profile shows Action required: review and finalize in Docue, the document was created but could not be sent automatically. This can happen when:

  • the candidate is missing a first name, last name or email address in Teamtailor
  • the template hasn't been set up for the integration
  • no signing method was chosen in the trigger.

Click Review and finalize in Docue on the candidate's profile, check the document, fill in anything missing and send it for signing. The status in Teamtailor updates automatically once you do.

Starting Docue again for the same candidate creates a new document, so check the first one in Docue before you try again.

Troubleshooting

  • "Docue access was denied": the API key is wrong or no longer valid. Update it in the Docue integration settings in Teamtailor.
  • "No compatible templates are available": your workspace doesn't have a template set up for the integration yet. Contact our customer support.
  • "The default Docue template is unavailable or incompatible": the template ID in the Default template setting is wrong or the template can't be used. Update or clear the setting.
  • The document isn't owned by anyone in Docue: no Docue user has the same email address as the recruiter in Teamtailor. Invite the recruiter to your Docue workspace with the same email address.
  • The link doesn't open the document: you need to be logged in to Docue and have access to the document.

Your data

The integration uses the candidate's name and email address only to fill in the document. It doesn't store candidate details outside Docue and Teamtailor.

If you need help, contact support@docue.com.

Last reviewed: