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

# Getting Started with Cano Analytics: Your First Event

> Send your first event and build your first live dashboard in Cano Analytics. This guide takes about 5 minutes from signup to your first insight.

This guide walks you through everything you need to go from a blank Cano account to a live dashboard tracking real user events. By the end, you'll have a workspace configured, an API key in hand, an event flowing into Cano from your app, and a dashboard displaying it — in about 5 minutes.

<Note>
  You need a Cano Analytics account to follow this guide. If you don't have one yet, sign up for free at [app.canoanalytics.io](https://app.canoanalytics.io). No credit card required.
</Note>

<Steps>
  <Step title="Create a Workspace">
    A workspace is the top-level container for all your data, team members, and dashboards in Cano. When you log in for the first time, Cano prompts you to create one automatically.

    1. Log in to [app.canoanalytics.io](https://app.canoanalytics.io).
    2. On the **Welcome** screen, enter a workspace name — typically your company or project name (e.g. `Acme Corp`).
    3. Select your industry and team size, then click **Create Workspace**.

    Cano provisions your workspace and drops you into the main dashboard. You're ready to start sending data.
  </Step>

  <Step title="Get Your API Key">
    Every request to Cano — whether from an SDK or a direct API call — is authenticated with a workspace API key.

    1. In the left sidebar, click **Settings**.
    2. Navigate to the **API Keys** tab.
    3. Click **Generate New Key**, give it a descriptive name (e.g. `Production Web App`), and click **Create**.
    4. Copy the key immediately — Cano only shows it once.

    <Warning>
      Treat your API key like a password. Never commit it to source control or expose it in client-side code for server-side-only keys. Use environment variables to inject keys at runtime.
    </Warning>
  </Step>

  <Step title="Install the SDK">
    Cano publishes official SDKs for JavaScript/TypeScript and Python. Choose the one that matches your stack and install it using your package manager.

    <CodeGroup>
      ```bash npm theme={null}
      npm install @cano/analytics
      ```

      ```bash yarn theme={null}
      yarn add @cano/analytics
      ```

      ```bash pip theme={null}
      pip install cano-analytics
      ```
    </CodeGroup>
  </Step>

  <Step title="Initialize and Track Your First Event">
    With the SDK installed, initialize the Cano client using your API key and call `track()` to send your first event. Replace `YOUR_API_KEY` with the key you copied in Step 2.

    <CodeGroup>
      ```javascript app.js theme={null}
      import { CanoAnalytics } from '@cano/analytics';

      const cano = new CanoAnalytics({
        apiKey: 'YOUR_API_KEY',
      });

      // Track a user signing up
      cano.track('user_signed_up', {
        userId: 'usr_123',
        properties: {
          plan: 'pro',
          source: 'organic',
        },
      });
      ```

      ```python app.py theme={null}
      from cano_analytics import CanoClient

      cano = CanoClient(api_key='YOUR_API_KEY')

      # Track a user signing up
      cano.track(
          'user_signed_up',
          user_id='usr_123',
          properties={
              'plan': 'pro',
              'source': 'organic',
          }
      )
      ```
    </CodeGroup>

    When the call succeeds, the SDK returns a confirmation object:

    ```json Expected Response theme={null}
    {
      "status": "ok",
      "event_id": "evt_01hx9kqz3mb2v7n4p6w8yd5r",
      "received_at": "2024-05-10T14:32:07.000Z"
    }
    ```
  </Step>

  <Step title="View the Event in Cano">
    Your event appears in the Cano UI within seconds of being sent.

    1. In the left sidebar, click **Events**.
    2. You'll see the **Live Events Feed** — a real-time stream of all incoming events.
    3. Find `user_signed_up` in the list. Click it to expand the full event payload and confirm your properties (`plan`, `source`) are attached correctly.

    <Info>
      The Live Events Feed shows events from the last 24 hours by default. Use the date picker in the top-right corner to extend the range.
    </Info>
  </Step>

  <Step title="Create Your First Dashboard">
    Now that events are flowing in, visualize them on a dashboard.

    1. In the left sidebar, click **Dashboards**, then click **New Dashboard**.
    2. Give your dashboard a name (e.g. `Sign-Up Funnel`) and click **Create**.
    3. Click **Add Chart**, select `user_signed_up` as the event, and choose **Line Chart** as the chart type.
    4. Click **Save Chart** — your first chart appears on the dashboard.

    For a full walkthrough of chart types, filters, and layout options, see the [Creating Dashboards](/docs/dashboards/creating-dashboards) guide.
  </Step>
</Steps>

<Tip>
  Now that your first event is live, explore what Cano can do next: set up [user identification](/docs/tracking/identify-users) to link events to profiles, connect a [data source](/docs/data-sources/overview) to enrich your data, or dive into the [JavaScript SDK reference](/docs/sdks/javascript) for advanced configuration options.
</Tip>