> ## Documentation Index
> Fetch the complete documentation index at: https://docs.timetracker.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrations overview

> How TimeTracker connects to other tools: Google Calendar sync, webhooks for your own systems, the mobile app, the Android widget and data export.

TimeTracker connects to the rest of your stack in three ways: a **calendar sync**,
**webhooks** to your own systems, and **apps** for your phone.

## What is available

| Integration                                        | What it does                                                   | Plan     |
| -------------------------------------------------- | -------------------------------------------------------------- | -------- |
| [Google Calendar](/integrations/google-calendar)   | Two-way sync of planned blocks                                 | Pro      |
| [Webhooks](/integrations/webhooks)                 | Push workspace events to any HTTPS endpoint                    | Pro      |
| [Mobile app](/integrations/mobile-app)             | Track time, tasks, timecards, expenses and leave on your phone | Included |
| [Android widget](/integrations/android-widget)     | Start and stop the timer from your home screen                 | Included |
| [Export your data](/integrations/import-your-data) | Take everything out in open formats                            | Pro      |

## Where to find them

| Screen                       | What is there                                                                    |
| ---------------------------- | -------------------------------------------------------------------------------- |
| **Settings → Integrations**  | Google Calendar. The page reads *"Connect external services to this workspace."* |
| **Settings → Webhooks**      | Your HTTPS endpoints and their delivery history                                  |
| **Settings → Data → Export** | A full export of the workspace                                                   |

Under **Settings**, the **Integrations** group in the sidebar holds two entries –
**Calendar** and **Webhooks**.

## Two apps gate this area

Integrations sit behind two switchable apps. Both are on by default.

| App                | Covers               | Requires         | Plan feature   |
| ------------------ | -------------------- | ---------------- | -------------- |
| **Calendar**       | Google Calendar sync | Resource Planner | `integrations` |
| **Webhooks & API** | Webhook endpoints    | –                | `integrations` |

Turning an app off hides its screens. It never deletes your configuration. See
[Apps and modules](/concepts/apps-and-modules).

<Note>
  **Turned off** and **not on your plan** are different. Off means hidden entirely.
  Not on your plan means the screen stays in the sidebar with a paywall over it.
</Note>

## Which one do you want?

<CardGroup cols={2}>
  <Card title="I live in Google Calendar" icon="calendar" href="/integrations/google-calendar">
    Sync your planned blocks both ways so your Planner shows your real week.
  </Card>

  <Card title="I want another system to react" icon="webhook" href="/integrations/webhooks">
    Push events like `invoice.paid` or `timesheet.approved` to your own endpoint.
  </Card>

  <Card title="I need to track time away from my desk" icon="mobile" href="/integrations/mobile-app">
    The mobile app covers time, tasks, timecards, expenses and leave.
  </Card>

  <Card title="I want one tap to start a timer" icon="grip" href="/integrations/android-widget">
    The Android home-screen widget.
  </Card>
</CardGroup>

## Choosing between calendar sync and webhooks

They solve different problems.

|               | Google Calendar             | Webhooks                             |
| ------------- | --------------------------- | ------------------------------------ |
| Direction     | Two-way                     | One-way, out of TimeTracker          |
| Set up by     | Each person, for themselves | An Owner or Admin, for the workspace |
| Capability    | `block.manage`              | `webhook.manage`                     |
| What moves    | Planned blocks              | Events, as signed JSON               |
| Who it is for | Anyone who plans work       | A developer                          |

## Example

Northwind Studio's setup:

<Steps>
  <Step title="Priya connects Google Calendar">
    Her client calls import as planned blocks, so the Planner shows her real
    capacity instead of an empty week.
  </Step>

  <Step title="Daniel adds a webhook">
    `invoice.paid` posts to the accounting system, so a payment recorded in
    TimeTracker lands in the ledger without anyone retyping it.
  </Step>

  <Step title="Sarah installs the mobile app">
    She starts a timer from her phone at a client site and it appears on her
    timesheet.
  </Step>

  <Step title="Maya exports monthly">
    A full JSON and CSV export goes into the studio's own archive.
  </Step>
</Steps>

## Permissions

| Integration           | Capability                              | Roles                                 |
| --------------------- | --------------------------------------- | ------------------------------------- |
| Google Calendar       | `block.manage`                          | Owner, Admin, Project Manager, Member |
| Webhooks              | `webhook.manage`                        | Owner, Admin                          |
| Full data export      | `data.export`, plus workspace ownership | Owner                                 |
| Mobile app and widget | `time.track`                            | Anyone who may track time             |

A webhook can carry every workspace event outside the product, which is why it is
restricted to the two roles that already administer the workspace.

## What is not available yet

Being straight about the gaps:

* **No importer.** There is no CSV upload and no connector for Toggl, Clockify or
  Harvest. See [Import your data](/integrations/import-your-data) for what to do
  instead.
* **No Slack app.** Route events to Slack through a
  [webhook](/integrations/webhooks) if you need it now.
* **No public REST API.** Webhooks push events out. There is no documented API to
  read data back in.

## Common questions

<AccordionGroup>
  <Accordion title="Is there a public API?">
    Not today. Webhooks push events out of TimeTracker over HTTPS with a signed
    payload. There is no documented read API.
  </Accordion>

  <Accordion title="Can I connect Slack or Microsoft Teams?">
    Not directly. Both accept incoming HTTPS payloads, so a small receiver in
    front of a [webhook](/integrations/webhooks) can post into a channel.
  </Accordion>

  <Accordion title="Can I import from Toggl or Harvest?">
    Not automatically. See [Import your data](/integrations/import-your-data).
  </Accordion>

  <Accordion title="Do integrations cost extra?">
    No. Google Calendar sync and webhooks are both part of Pro. The mobile app
    and widget are included on every plan.
  </Accordion>

  <Accordion title="Does turning an app off delete my setup?">
    No. Configuration and history are kept. Webhook events that happen while the
    app is off are queued and delivered when you turn it back on.
  </Accordion>
</AccordionGroup>

## Troubleshooting

**An integration screen is missing.** The app that owns it is off. Check
**Settings → Apps**.

**A screen shows a paywall.** Your plan does not include `integrations`. See
[Plans and features](/concepts/plans-and-features).

**I can see the screen but not the buttons.** You do not hold the capability. The
page usually says which one. See
[Roles and capabilities](/concepts/roles-and-capabilities).

## Related guides

<CardGroup cols={2}>
  <Card title="Google Calendar" icon="calendar" href="/integrations/google-calendar">
    Two-way sync of planned blocks.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/integrations/webhooks">
    Push events to your own systems.
  </Card>

  <Card title="Mobile app" icon="mobile" href="/integrations/mobile-app">
    TimeTracker on your phone.
  </Card>

  <Card title="Android widget" icon="grip" href="/integrations/android-widget">
    Start a timer from your home screen.
  </Card>

  <Card title="Import your data" icon="upload" href="/integrations/import-your-data">
    Moving from another tool.
  </Card>

  <Card title="Apps and modules" icon="toggle-on" href="/concepts/apps-and-modules">
    Turning integration apps on and off.
  </Card>
</CardGroup>