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

# Create a Send SMS tool

> Connect Twilio, send a test message, and publish a Send SMS tool.

Create one Send SMS tool for your organization, then attach its published
version to any agent that should send messages during a call.

## Prerequisites

* A Twilio account with an SMS-capable phone number.
* The Twilio Account SID and Auth Token.
* Permission to manage organization tools and Vault secrets.

<Steps>
  <Step title="Open Send SMS">
    Go to **Global Tools**, choose **New tool**, then select **Send SMS** under
    **Pre configured**.

    <Frame caption="Select Send SMS from the New tool page">
      <img src="https://mintcdn.com/slng-new-docs/fgzHSTXC7k7AhIuF/heroshots/tools-new.png?fit=max&auto=format&n=fgzHSTXC7k7AhIuF&q=85&s=73ee874c7ce4e6e9eb579dab03a593d8" alt="The New tool page with Send SMS highlighted" width="2560" height="1600" data-path="heroshots/tools-new.png" />
    </Frame>
  </Step>

  <Step title="Connect Twilio">
    Enter the Twilio **Account SID** and **Auth token**. The dashboard stores
    them in your Vault as `TWILIO_ACCOUNT_SID` and `TWILIO_AUTH_TOKEN`.

    <Frame caption="Configure Twilio and test the Send SMS tool">
      <img src="https://mintcdn.com/slng-new-docs/fgzHSTXC7k7AhIuF/images/tools/send-sms.png?fit=max&auto=format&n=fgzHSTXC7k7AhIuF&q=85&s=062f5d2084116905c00eae04c262ad17" alt="The Send SMS editor with Twilio credentials and the Test panel" width="2558" height="1734" data-path="images/tools/send-sms.png" />
    </Frame>
  </Step>

  <Step title="Send a test message">
    Enter a verified recipient, message body, and SMS-capable Twilio sender in
    the **Test** panel. Use E.164 numbers such as `+15551234567`.

    You must complete a successful test before publishing the tool.
  </Step>

  <Step title="Publish the tool">
    Choose **Publish**. Publishing creates an immutable numbered version.

    If publishing fails, review the Twilio credentials, phone numbers, and the
    latest test result.
  </Step>

  <Step title="Attach it to an agent">
    Attach the published version, then set `recipient`, `body`, and
    `from_number` for that agent. `from_number` must be a literal E.164 number.
    `recipient` and `body` can use call values.

    See [Attach a tool to an agent](/guides/agents/tools-and-mcp/attach-to-an-agent).
  </Step>
</Steps>

## Verify the result

Open **Global Tools** and confirm that Send SMS shows a published version. Then
place a test call and ask the agent to send a message. Confirm that Twilio
accepted the message and that the agent received a successful tool result.