Skip to main content

Teamtailor (Source)

The Teamtailor source connector lets you authenticate to the Teamtailor API and validate credentials. Extraction and streams are not yet available.

Setup

Prerequisites

  • A Teamtailor account
  • An API key (Teamtailor access token)
  • Your Teamtailor API region: EU, NA, or AU

Create an API key in Teamtailor

In Teamtailor, create or obtain an API key with access to the resources you intend to sync. Keep this key secure; it will be used as the connector credential.

Authentication

This connector authenticates using a Teamtailor API key sent in the Authorization header:

  • Header: Authorization: Token token=<API_KEY>
  • Header: Accept: application/vnd.api+json

During connection testing, the connector validates credentials by calling:

  • GET /v1/company

Configuration

FieldTypeRequiredDescription
api_keystringYour Teamtailor API key.
regionstringTeamtailor API region. Must be one of: EU, NA, AU.

Region to API base URL mapping

  • EUhttps://api.teamtailor.com
  • NAhttps://api.na.teamtailor.com
  • AUhttps://api.au.teamtailor.com

Streams

This connector is currently under development and does not yet expose any streams.

Limitations

  • Extraction is not yet implemented. Connection testing (credential validation) is supported, but syncing data is not available yet.