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

# Quickstart

> Start collecting form submissions with Heysheet in under 5 minutes

## Get started with Heysheet

Heysheet lets developers send form submissions directly to Google Sheets using a simple API — no backend needed.

This quickstart will walk you through:

1. Connecting your Google Sheet
2. Sending a form submission
3. Previewing data in your Sheet

***

## 1. Connect your Google Sheet

To begin:

<AccordionGroup>
  <Accordion icon="google-sheets" title="Authorize Google Sheets">
    Head over to your [Heysheet Dashboard](https://heysheet-landing-nine.vercel.app/) and connect your Google account.\
    Select the spreadsheet you want to use to collect responses.

    > ✅ Heysheet will ask for minimal permissions and only needs access to the sheet(s) you select.
  </Accordion>

  <Accordion icon="table" title="Map your sheet columns">
    Once connected, Heysheet will let you map form fields to your sheet's column headers.\
    This determines where each submitted value will be stored.
  </Accordion>
</AccordionGroup>

***

## 2. Send your first submission

You can now start sending data to your sheet using the generated API endpoint.

<AccordionGroup>
  <Accordion icon="code" title="Send a POST request">
    Here's a sample `fetch` request to submit form data:

    ```ts theme={null}
    await fetch("https://api.heysheet.in/forms/your-form-id", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        name: "John Doe",
        email: "john@example.com",
        message: "Hey, this is my submission!"
      }),
    });
    ```

    You can also use `curl` or any HTTP client (like Axios, SuperAgent, etc).
  </Accordion>

  <Accordion icon="shield-check" title="Secure your endpoint">
    * Each endpoint is rate-limited and protected from abuse.
    * For added security, you can enable CAPTCHA and domain whitelisting in the dashboard.
  </Accordion>
</AccordionGroup>

***

## 3. View responses in your Sheet

Once the form is submitted, data will appear instantly in your connected Google Sheet.

> 📌 No need to refresh — it updates in real-time.

***

## What's next?

Update your docs or integration with more advanced features.

<CardGroup>
  <Card title="Upload Files" icon="upload" href="/features/file-upload">
    Accept file uploads and link them directly in your Sheet.
  </Card>

  <Card title="Get Alerts on Submissions" icon="bell" href="/features/alerts">
    Set up email or Slack notifications for new submissions.
  </Card>

  <Card title="Use with React or HTML" icon="brackets" href="/guides/react-integration">
    Learn how to use Heysheet with your frontend framework.
  </Card>

  <Card title="Enable Spam Protection" icon="bug" href="/guides/security">
    Prevent spam with CAPTCHA and domain restrictions.
  </Card>
</CardGroup>