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

# Quick Start (SMS API)

> This guide will help you get started with Hypersender SMS API and send your first message.

## <Icon icon="bolt" size={28} /> How To Starts

<Steps>
  <Step title="Create an account">
    To get started, you need to create an account on Hypersender. Visit [Hypersender](https://app.hypersender.com/login) and click on the Sign Up button.
  </Step>

  <Step title="Create an Instance">
    After you have successfully created an account, you need to create an instance. An instance represents a one phone number and the app on your android phone. You can create multiple instances for different phone numbers.

    1. Click on the **Create Instance** button.
    2. Select Service Type: **WhatsApp**
    3. Enter a name for your instance.
    4. Enter your phone number. i.e. `+2011313311331`, make sure it's a working number and you have access to it.
    5. Enter a description for your instance **(Optional)**.
  </Step>

  <Step title="Copy API Key">
    After you have created an instance successfully, you will be redirected to the instance listing page. You'll immediately see a notification to copy your API key. Click on the **Copy** button to copy the API key to your clipboard.

    Copy `instanceId` and `apiKey`, you will need them to authenticate your requests.
  </Step>

  <Step title="Download the Hypersender SMS App">
    Currently, Google Play Store does not allow SMS apps to be published. So you need to download the app from the Hypersender website.

    1. Visit the Github release page: [Hypersender SMS App](https://github.com/hypersender/sms-app-releases/releases).
    2. Click on the Download App button.
    3. Scan the QR code using your phone to download the app.

    ### Required App Permissions

    In order for Hypersender to work properly, you need to grant the following permissions to the app:

    <Steps>
      <Step title="Sending Notifications">
        This permission is required for Hypersender to send notifications to your phone.

        <Frame>
          <img src="https://mintcdn.com/hypersender/dAZ_QYs7yJAVpPpO/images/permissions/send-notifications.jpeg?fit=max&auto=format&n=dAZ_QYs7yJAVpPpO&q=85&s=05c2957cda08c9ea585e3a8accb5a103" alt="Allow Hypersender SmS to send you notifications" width="1200" height="892" data-path="images/permissions/send-notifications.jpeg" />
        </Frame>
      </Step>

      <Step title="Send and View Messages">
        This permission is required for Hypersender to send and view messages on your phone.

        <Frame>
          <img src="https://mintcdn.com/hypersender/dAZ_QYs7yJAVpPpO/images/permissions/send-messages.jpeg?fit=max&auto=format&n=dAZ_QYs7yJAVpPpO&q=85&s=5c07417feaa74f708d58fa29c1b02d3f" alt="Allow Hypersender SmS to send and view messages" width="1198" height="983" data-path="images/permissions/send-messages.jpeg" />
        </Frame>
      </Step>

      <Step title="Manage Phone Calls">
        This permission is required for Hypersender to make and manage phone calls on your phone.

        <Frame>
          <img src="https://mintcdn.com/hypersender/dAZ_QYs7yJAVpPpO/images/permissions/manage-phone-calls.jpeg?fit=max&auto=format&n=dAZ_QYs7yJAVpPpO&q=85&s=ff9ad657d6d42b47ca18fbca00ef09fe" alt="Allow Hypersender SmS to make and manage phone calls" width="1198" height="983" data-path="images/permissions/manage-phone-calls.jpeg" />
        </Frame>
      </Step>

      <Step title="Access Phone Logs">
        This permission is required for Hypersender to access and view your phone logs.

        <Frame>
          <img src="https://mintcdn.com/hypersender/dAZ_QYs7yJAVpPpO/images/permissions/phone-logs.jpeg?fit=max&auto=format&n=dAZ_QYs7yJAVpPpO&q=85&s=fddd9a46de73c7a3bc962abed203a669" alt="Allow Hypersender SmS to access phone logs" width="1198" height="888" data-path="images/permissions/phone-logs.jpeg" />
        </Frame>
      </Step>
    </Steps>

    ### Battery Optimization

    Hypersender needs to work continuously in the background to send, receive, view, and manage messages, so it's important to disable battery optimization for the app.

    Hypersender will asks you to disable battery optimization when you first open it. Click on the **Ignore Battery Optimization** button to disable battery optimization for the app.

    <Frame>
      <img src="https://mintcdn.com/hypersender/dAZ_QYs7yJAVpPpO/images/permissions/battery.jpeg?fit=max&auto=format&n=dAZ_QYs7yJAVpPpO&q=85&s=eaa25e0d2b2c149d09cf69bb5b49078c" alt="Disable battery optimization for Hypersender SmS" width="636" height="404" data-path="images/permissions/battery.jpeg" />
    </Frame>

    <Warning>
      If for some reason you missed the battery optimization prompt, you can disable battery optimization manually by following these steps:

      1. Open **Settings** on your phone.
      2. Search for **Battery Optimization**.
      3. Search for **Hypersender SMS** and disable battery optimization for the app.
    </Warning>
  </Step>

  <Step title="Connect your SMS App">
    You'll notice that connection status is **Disconnected**. To connect your SMS app, you need to enter the API key you copied earlier in the app.
  </Step>

  <Step title="Send your first message">
    After you have successfully connected your SMS app, you should see the connection status as **Connected**. Now you can send your first message.
  </Step>
</Steps>

## Quick Demo

<Tip>
  Learn how to use Hypersender SMS API to send a message using Postman: [Demo Link](https://docs.hypersender.com/api-reference/sms/how-to-send-sms-message-in-postman).
</Tip>

## postman collection

You can download SMS API Postman Collection to easily interact with our API.

<a href="/api-reference/sms/sms-collection.json" download>
  <Card title="Download Collection" icon="book-open">
    Download SMS API Postman Collection.
  </Card>
</a>
