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

# FusionDesk Quickstart: Up and Running in 10 Minutes

> Set up your FusionDesk workspace, invite your team, create your first support ticket, and make your first API call — all in under 10 minutes.

Welcome to FusionDesk! This guide walks you through everything you need to go from a brand-new account to handling your first support ticket — including workspace configuration, team setup, and connecting via the API. By the end, you'll have a fully operational workspace ready for real work.

<Steps>
  <Step title="Sign up and access your workspace">
    Head to [fusiondesk.in](https://fusiondesk.in) and click **Get Started Free**. Enter your work email address and choose a password, then verify your email using the confirmation link sent to your inbox.

    Once verified, you'll land on your personal FusionDesk dashboard. Your workspace URL follows the pattern:

    ```text theme={null}
    https://<your-workspace>.fusiondesk.in
    ```

    Bookmark this URL — it's your team's home base inside FusionDesk.

    <Tip>
      Use your company domain email when signing up. FusionDesk can automatically match future teammates to your workspace when they register with the same domain.
    </Tip>
  </Step>

  <Step title="Configure your workspace">
    Before inviting anyone, take two minutes to personalise your workspace so your team recognises it immediately.

    1. Open the **Settings** menu from the left sidebar.
    2. Select **Workspace Settings → General**.
    3. Set your **Workspace Name** (e.g., *Acme Support*).
    4. Upload a **logo** and choose your **brand colour** — both appear in outgoing email notifications and the agent portal.
    5. Set your **default timezone** so SLA clocks and timestamps are accurate for your team.
    6. Click **Save Changes**.

    <Note>
      Your workspace name appears in all customer-facing emails and in the browser tab your agents see every day — choose something clear and recognisable.
    </Note>
  </Step>

  <Step title="Invite your team members">
    A support operation runs on people. Bring your team in now so they're ready when tickets start arriving.

    1. Go to **Settings → Team Members** and click **Invite Members**.
    2. Enter one or more email addresses (comma-separated for bulk invites).
    3. Assign each invitee a **role**: *Administrator*, *Agent*, or *Viewer*. See [Core Concepts](/core-concepts) for a full breakdown of permissions per role.
    4. Click **Send Invites**.

    Teammates receive an email with a direct link to join your workspace. Their account is created the moment they accept.

    <Tip>
      You can re-send or revoke pending invitations at any time from the **Pending Invites** tab in Team Members settings.
    </Tip>
  </Step>

  <Step title="Create your first ticket">
    With your workspace configured and your team on board, create a ticket to see FusionDesk's helpdesk flow in action.

    1. Click **New Ticket** in the top-right corner of the dashboard.
    2. Fill in the required fields:
       * **Subject** — a short, descriptive title for the issue.
       * **Description** — full details of the customer's problem.
       * **Priority** — choose *Low*, *Medium*, *High*, or *Urgent*.
       * **Assignee** — pick a team member or leave it unassigned for now.
    3. Click **Create Ticket**.

    Your ticket is now live in the queue. You can update its status, add internal notes, attach files, and log time directly from the ticket detail view.

    <Info>
      FusionDesk automatically calculates SLA deadlines the moment a ticket is created, based on its priority level and the SLA policy attached to your workspace.
    </Info>
  </Step>

  <Step title="Connect via the API">
    FusionDesk's REST API lets you create and manage tickets programmatically — perfect for automating intake from your own apps or integrations.

    **Retrieve your API key**

    1. Go to **Settings → API & Integrations**.
    2. Click **Generate API Key** (or copy an existing one).
    3. Store the key securely — it won't be shown again after you navigate away.

    **Make your first API call**

    Use the key as a Bearer token in the `Authorization` header. The example below creates a ticket via `POST /tickets`:

    <CodeGroup>
      ```bash cURL theme={null}
      curl --request POST \
        --url https://api.fusiondesk.in/v1/tickets \
        --header 'Authorization: Bearer YOUR_API_KEY' \
        --header 'Content-Type: application/json' \
        --data '{
          "subject": "Login page returns 500 error",
          "description": "Users on the enterprise plan cannot log in. The page returns a 500 after entering credentials.",
          "priority": "high",
          "assignee_email": "agent@yourcompany.com"
        }'
      ```

      ```python Python theme={null}
      import requests

      url = "https://api.fusiondesk.in/v1/tickets"
      headers = {
          "Authorization": "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
      }
      payload = {
          "subject": "Login page returns 500 error",
          "description": "Users on the enterprise plan cannot log in. The page returns a 500 after entering credentials.",
          "priority": "high",
          "assignee_email": "agent@yourcompany.com",
      }

      response = requests.post(url, json=payload, headers=headers)
      print(response.json())
      ```

      ```js Node.js theme={null}
      const response = await fetch("https://api.fusiondesk.in/v1/tickets", {
        method: "POST",
        headers: {
          Authorization: "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          subject: "Login page returns 500 error",
          description:
            "Users on the enterprise plan cannot log in. The page returns a 500 after entering credentials.",
          priority: "high",
          assignee_email: "agent@yourcompany.com",
        }),
      });

      const ticket = await response.json();
      console.log(ticket);
      ```
    </CodeGroup>

    A successful request returns `201 Created` with the full ticket object, including the system-generated `ticket_id` you can use for future updates.

    <Warning>
      Never expose your API key in client-side code or public repositories. Rotate compromised keys immediately from **Settings → API & Integrations**.
    </Warning>
  </Step>
</Steps>

<Note>
  **Mobile access** — FusionDesk is fully responsive and works in any mobile browser. Native iOS and Android apps are available on the App Store and Google Play, giving your agents real-time push notifications for new tickets and SLA alerts on the go.
</Note>

***

## What's next?

You're up and running. Explore these resources to go deeper:

<CardGroup cols={2}>
  <Card title="Creating and Managing Tickets" icon="ticket" href="/guide/tickets/create-tickets">
    Learn how to organise, prioritise, filter, and resolve tickets at scale — including bulk actions, saved views, and SLA management.
  </Card>

  <Card title="API Reference" icon="code" href="/api/overview">
    Explore the full FusionDesk REST API: endpoints for tickets, projects, tasks, users, and webhooks — with live request examples.
  </Card>
</CardGroup>