> ## Documentation Index
> Fetch the complete documentation index at: https://nango-wari-migrated-bigcommerce-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Timify - How do I link my account?

# Overview

To authenticate with Timify, you will need:

1. **App ID** - The identifier for your app in the Developer Platform.
2. **App Secret** - The secret used with your App ID to obtain access tokens for API authentication.

This guide will walk you through creating an app, getting these credentials, and connecting in Nango.

### Prerequisites

* Access to the TIMIFY Developer Platform. Request this from your Account Manager; they will arrange a developer account. You receive an invitation by email and must accept it within 7 days.
* Access to a Company or Enterprise account where the app can be installed.

### Instructions:

#### Step 1: Finding your subdomain

1. The subdomain is the first part of your API base URL, for example, in `https://api.timify.com` the subdomain is `api`.

#### Step 2: Create and install the app

1. Log in to the [Timify Developer Platform](https://api.timify.com) and go to **Apps** to see the **App Dashboard** → **+ NEW APP**.

<img src="https://mintcdn.com/nango-wari-migrated-bigcommerce-docs/SQGEy_hbAk3xfLIQ/api-integrations/timify/app_dashboard.png?fit=max&auto=format&n=SQGEy_hbAk3xfLIQ&q=85&s=9bc739fec24270e8b72292e60df3e8e7" width="640" height="332" data-path="api-integrations/timify/app_dashboard.png" />

2. Choose app type: **TIMIFY Backend App** (for data sync).

<img src="https://mintcdn.com/nango-wari-migrated-bigcommerce-docs/SQGEy_hbAk3xfLIQ/api-integrations/timify/app_type.png?fit=max&auto=format&n=SQGEy_hbAk3xfLIQ&q=85&s=f2920974660a4608f6b7b2be603554ca" width="640" height="373" data-path="api-integrations/timify/app_type.png" />

3. Set **Visibility** and **Country Visibility** if needed.

<img src="https://mintcdn.com/nango-wari-migrated-bigcommerce-docs/SQGEy_hbAk3xfLIQ/api-integrations/timify/app_visibility.png?fit=max&auto=format&n=SQGEy_hbAk3xfLIQ&q=85&s=4b1a3cf3415a6ba6071f623e8aa786a9" width="640" height="351" data-path="api-integrations/timify/app_visibility.png" />

4. Select **Scopes** for your integration (you can change these while the app is in Draft).

<img src="https://mintcdn.com/nango-wari-migrated-bigcommerce-docs/SQGEy_hbAk3xfLIQ/api-integrations/timify/app_scopes.png?fit=max&auto=format&n=SQGEy_hbAk3xfLIQ&q=85&s=ddfc750599d469a77874af46a1978fe5" width="640" height="475" data-path="api-integrations/timify/app_scopes.png" />

5. Authorise your app using the Private Access Key, which can be found in your TIMIFY Company or Enterprise account.

<img src="https://mintcdn.com/nango-wari-migrated-bigcommerce-docs/SQGEy_hbAk3xfLIQ/api-integrations/timify/generate_private_key.png?fit=max&auto=format&n=SQGEy_hbAk3xfLIQ&q=85&s=df68c6bf8273f23f09479c63a3406ea6" width="640" height="412" data-path="api-integrations/timify/generate_private_key.png" />

6. Enter your **App Name** and **Category** then **Create App**.

<img src="https://mintcdn.com/nango-wari-migrated-bigcommerce-docs/SQGEy_hbAk3xfLIQ/api-integrations/timify/create_app.png?fit=max&auto=format&n=SQGEy_hbAk3xfLIQ&q=85&s=263179e81aa3fccb7ac235e71782ed2c" width="640" height="457" data-path="api-integrations/timify/create_app.png" />

7. In your Company or Enterprise account go to **Apps** → **Private Apps** → find your app → **Install**.

<img src="https://mintcdn.com/nango-wari-migrated-bigcommerce-docs/SQGEy_hbAk3xfLIQ/api-integrations/timify/install_app_1.png?fit=max&auto=format&n=SQGEy_hbAk3xfLIQ&q=85&s=3f5ef1eb3482a5e17abde0f9c5d53ae7" width="640" height="585" data-path="api-integrations/timify/install_app_1.png" />

<img src="https://mintcdn.com/nango-wari-migrated-bigcommerce-docs/SQGEy_hbAk3xfLIQ/api-integrations/timify/install_app_2.png?fit=max&auto=format&n=SQGEy_hbAk3xfLIQ&q=85&s=433b849f15a875478bf3ec902adf5236" width="640" height="464" data-path="api-integrations/timify/install_app_2.png" />

<Tip>
  Install the app on your **Enterprise** account if you need it across multiple companies/branches. One app can be installed on only one account (company or enterprise).
</Tip>

***

#### Step 3: Getting your credentials

1. In the Developer Platform, open your app and go to **App Overview** (right-hand panel).
2. Copy **App ID** and **App Secret**.

<img src="https://mintcdn.com/nango-wari-migrated-bigcommerce-docs/SQGEy_hbAk3xfLIQ/api-integrations/timify/credentials.png?fit=max&auto=format&n=SQGEy_hbAk3xfLIQ&q=85&s=5210e3e111780f9aa6219f3abcbdbab2" width="640" height="343" data-path="api-integrations/timify/credentials.png" />

Each app has a lifecycle status (Draft, Pending, Approved, etc.) that affects editability and usage. See [App Status](https://docs.timify.dev/docs/first-steps#app-status) in the Timify docs.

#### Step 4: Enter credentials in the Connect UI

Once you have your **Subdomain**, **App ID**, and **App Secret**:

1. Open the form where you need to authenticate with Timify.
2. Enter your **Subdomain** (e.g. `api` for [https://api.timify.com](https://api.timify.com)), **App ID**, and **App Secret** in their respective fields.
3. Submit the form, and you should be successfully authenticated.

<img src="https://mintcdn.com/nango-wari-migrated-bigcommerce-docs/SQGEy_hbAk3xfLIQ/api-integrations/timify/form.png?fit=max&auto=format&n=SQGEy_hbAk3xfLIQ&q=85&s=55655355491f1454c350db4a8ed2f0fa" style={{maxWidth: "450px" }} width="500" height="699" data-path="api-integrations/timify/form.png" />

You are now connected to Timify.
