Timetastic

🚀 Quickstart

Connect to Timetastic with Nango and see data flow in 2 minutes. Timetastic uses a static bearer token generated directly in your Timetastic account.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Timetastic.

Connect your Timetastic account

Go to Connections -> Add Test Connection. Enter your API key, then save.

Call the Timetastic API

Let’s make your first request to the Timetastic API. Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/users" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/users',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain an API key, follow the setup guide linked below.

📚 Timetastic integration guides

Nango maintained guides for common use cases.

How to connect your Timetastic account
Generate an API key in Timetastic and connect it to Nango

Official docs: Timetastic API docs

🧩 Pre-built syncs & actions for Timetastic

Enable them in your dashboard. Extend and customize to fit your needs.

Others

Function name	Description	Type	Source code
`action-holiday`	Approve, decline, cancel, or delete a leave request.	Action	🔗 Github
`add-department`	Create a new department.	Action	🔗 Github
`add-locked-date`	Create a locked date period that blocks leave requests.	Action	🔗 Github
`add-user-toil`	Add a Time Off In Lieu entry for a user for a year.	Action	🔗 Github
`add-user`	Create a new user, optionally sending a welcome email.	Action	🔗 Github
`archive-user`	Archive a user, immediately logging them out and blocking further login.	Action	🔗 Github
`assign-user-public-holidays`	Turn on and assign a public holiday set (country/region) to a user	Action	🔗 Github
`create-leave-type`	Create a new leave type. Admin only.	Action	🔗 Github
`delete-department`	Delete a department.	Action	🔗 Github
`delete-leave-type`	Delete a leave type. Admin only.	Action	🔗 Github
`delete-locked-date`	Remove a locked date period. Admin/manager only.	Action	🔗 Github
`delete-user-toil`	Delete a TOIL entry for a user.	Action	🔗 Github
`edit-department`	Update a department’s settings.	Action	🔗 Github
`edit-user`	Update fields on an existing user.	Action	🔗 Github
`get-department`	Retrieve a single department.	Action	🔗 Github
`get-holiday`	Retrieve a single leave request.	Action	🔗 Github
`get-leave-type`	Retrieve a single leave type.	Action	🔗 Github
`get-public-holiday`	Retrieve a single public holiday.	Action	🔗 Github
`get-user-allowance-for-year`	Get the allowance, TOIL, and carry-forward for one user for one year.	Action	🔗 Github
`get-user-allowances`	Get allowance, TOIL, and carry-forward records for one user across all years.	Action	🔗 Github
`get-user`	Retrieve a single user, including their work schedule and per-year allowances.	Action	🔗 Github
`list-absences`	Get a chronological, day-by-day list of who is off within a date range.	Action	🔗 Github
`list-departments`	List all departments for the organisation.	Action	🔗 Github
`list-holidays`	Query leave requests for the organisation with rich filters.	Action	🔗 Github
`list-leave-type-colors`	List valid color hex codes for leave types.	Action	🔗 Github
`list-leave-type-icons`	List valid icon names for leave types.	Action	🔗 Github
`list-leave-types`	List leave types for the organisation.	Action	🔗 Github
`list-locked-dates`	List all locked date periods for the organisation.	Action	🔗 Github
`list-public-holiday-countries`	List all countries with public holiday sets available.	Action	🔗 Github
`list-public-holidays`	List public holidays for the organisation.	Action	🔗 Github
`list-user-allowances-for-year`	List allowances, TOIL, and carry-forwards for every user for a single year	Action	🔗 Github
`list-user-allowances`	List allowances, TOIL, and carry-forwards for every user across all years.	Action	🔗 Github
`list-users`	List users for the organisation.	Action	🔗 Github
`list-webhook-events`	List recent webhook delivery events.	Action	🔗 Github
`request-holiday`	Submit a leave request for a user, department, or the whole organisation	Action	🔗 Github
`restore-user`	Restore an archived user so they can log in again.	Action	🔗 Github
`update-leave-type`	Update an existing leave type. Admin only.	Action	🔗 Github
`update-user-allowance`	Update a user’s annual leave allowance for a year.	Action	🔗 Github
`update-user-carryforward`	Update a user’s carried-forward allowance for a year.	Action	🔗 Github
`update-user-toil`	Update an existing TOIL entry for a user for a year.	Action	🔗 Github
`departments`	Sync departments.	Sync	🔗 Github
`holidays`	Sync leave requests.	Sync	🔗 Github
`leave-types`	Sync leave types.	Sync	🔗 Github
`locked-dates`	Sync locked date periods.	Sync	🔗 Github
`public-holidays`	Sync public holidays.	Sync	🔗 Github
`user-allowances`	Sync user allowances, TOIL, and carry-forwards.	Sync	🔗 Github
`users`	Sync users.	Sync	🔗 Github

Overview

900+ APIs & Integrations

🚀 Quickstart

📚 Timetastic integration guides

🧩 Pre-built syncs & actions for Timetastic

Others

​🚀 Quickstart

​📚 Timetastic integration guides

​🧩 Pre-built syncs & actions for Timetastic

​Others

🚀 Quickstart

📚 Timetastic integration guides

🧩 Pre-built syncs & actions for Timetastic

Others