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

# Send your first SMS

> Send your first SMS with the Wavix API in a few minutes. The same request works in the sandbox and after you go live, with no code changes.

<Info>
  **This quickstart is for sandbox accounts.** New accounts start in the [sandbox](/getting-started/sandbox), so you'll send an SMS to your own verified number and receive it on your phone. The same request works for any recipient after you [go live](/getting-started/go-live), with no code changes.
</Info>

This tutorial walks you through sending your first SMS with the Wavix API.

## Prerequisites

* A [Wavix account](/getting-started/create-account). A sandbox account works.
* Your [API key](/api-reference/authentication).

<Tip>
  Prefer not to write code? Connect an AI client to the [Wavix MCP server](/mcp/overview) and send the same test message in natural language.
</Tip>

<Steps>
  <Step title="Find your sender number">
    When your sandbox becomes active, Wavix provisions a free phone number to your account. You'll use it as the sender.

    1. Sign in to the [Wavix portal](https://app.wavix.com).
    2. Go to **Numbers & trunks**.
    3. Copy the number listed under **My numbers**, in E.164 format.

    If you've already gone live, use any registered [Sender ID](/messaging/send-sms#sender-id-registration) as the sender instead.
  </Step>

  <Step title="Send the message">
    Send a `POST` request to the messages endpoint. Replace the API key, the sender number (`from`), and the destination (`to`).

    <Note>
      In the sandbox, `to` must be your verified number. The platform rejects any other destination. For the full rules, see [Sandbox](/getting-started/sandbox).
    </Note>

    <CodeGroup>
      ```bash cURL theme={null}
      curl --request POST \
        --url https://api.wavix.com/v3/messages \
        --header 'Authorization: Bearer your_api_key_here' \
        --header 'Content-Type: application/json' \
        --data '{
          "from": "447441477410",
          "to": "12015551234",
          "message_body": {
            "text": "Hello from Wavix."
          }
        }'
      ```

      ```javascript Node.js theme={null}
      const response = await fetch("https://api.wavix.com/v3/messages", {
        method: "POST",
        headers: {
          Authorization: `Bearer ${process.env.WAVIX_API_KEY}`,
          "Content-Type": "application/json",
        },
        body: JSON.stringify({
          from: "447441477410", // your provisioned number (sandbox) or registered Sender ID
          to: "12015551234", // in the sandbox, this must be your verified number
          message_body: { text: "Hello from Wavix." },
        }),
      });

      if (!response.ok) {
        throw new Error(`Wavix API error: ${response.status} ${await response.text()}`);
      }

      const message = await response.json();
      console.log(message.message_id, message.status);
      ```
    </CodeGroup>

    If successful, the service returns the `HTTP 201 Created` status code and the message details, including a `message_id` and a `status` of `accepted`. Your verified number should receive the message shortly.
  </Step>

  <Step title="Check delivery">
    Use the `message_id` from the response to check the delivery status:

    ```http theme={null}
    GET https://api.wavix.com/v3/messages/{message_id}
    Authorization: Bearer your_api_key_here
    ```

    The `status` field moves from `accepted` to `sent` to `delivered`. For what each status means, see [Send SMS messages](/messaging/send-sms#get-message-details).

    You can also check delivery in the Wavix portal. In the top menu, select **History** → **SMS history**, then open the **Outbound** tab to see your sent messages and their status.
  </Step>
</Steps>

## Next steps

* Send to any recipient: [Go live](/getting-started/go-live).
* Use MMS, tags, and other options: [Send SMS messages](/messaging/send-sms).
* Receive and reply to messages: [Receive SMS messages](/messaging/receive-sms).