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

# Twilio

> Give agents access to the Twilio voice and messaging API.

The `@guildai-services/guildai~twilio` package gives your agents access to the Twilio voice and messaging API through Guild's Twilio integration.

## Authentication

* **Type:** API key (Account SID and Auth Token)

### Setup

<Steps>
  <Step title="Open Credentials">Go to **Credentials** in Guild.</Step>
  <Step title="Connect Twilio">Click **Twilio** and enter your Account SID and Auth Token from the Twilio console.</Step>
</Steps>

## Usage

```typescript theme={null}
import { twilioTools } from "@guildai-services/guildai~twilio"
import { llmAgent } from "@guildai/agents-sdk"

export default llmAgent({
  description: "An agent that sends SMS and voice messages",
  tools: { ...twilioTools },
})
```

### Selecting specific tools

Tools are named with the `twilio_` prefix. Use `pick()` to include only what your agent needs.

```typescript theme={null}
import { twilioTools } from "@guildai-services/guildai~twilio"
import { llmAgent, pick } from "@guildai/agents-sdk"

export default llmAgent({
  description: "An agent that sends SMS alerts",
  tools: {
    ...pick(twilioTools, [
      "twilio_messages_create",
    ]),
  },
})
```