---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/content/twilio-quick-reply#article
headline: twilio/quick-reply
description: Send interactive messages with up to ten quick-reply buttons over WhatsApp or Facebook Messenger by using the twilio/quick-reply content type.
url: https://www.twilio.com/docs/content/twilio-quick-reply
inLanguage: en
dateModified: 2026-07-31T17:08:38.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# twilio/quick-reply

The `twilio/quick-reply` content type lets recipients tap, rather than type, to respond to a message. You can include up to ten quick-reply buttons. When you send an in-session WhatsApp message that does **not** require template approval, only three buttons are allowed.

> \[!WARNING]
>
> `twilio/quick-reply` content templates can be sent over WhatsApp for out-of-session messages that include variables. If the template body starts or ends with a variable, or if two variables appear adjacent to each other, WhatsApp will reject the template. A sample value for each variable is required. For details, see [Using Variables with Content Templates](/docs/content/using-variables-with-content-api).

## Supported channels

* WhatsApp
* Facebook Messenger

## Message preview

| ![Chat options: Check Flight Status, Check Gate Number, Speak with an Agent.](https://docs-resources.prod.twilio.com/3e2a5c43d23f991c60d5b8bb868f114d1434406c8347038e72d30a360556288a.png) | ![Chat from Owl Air Support offering options to check flight status, gate number, or see all options.](https://docs-resources.prod.twilio.com/638b380283b8d489512fb3a33d0174f17f17c04aa00dbc5f6c0cad3154ff691d.png) | ![Menu with options for flight status, gate number, agent contact, and weather at DEP and ARR.](https://docs-resources.prod.twilio.com/b2fddf1a4ea91b70a59e1c1843e40f9ee2ef6f5b2a9171e9d5597fbd198c15d8.png) |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

## Data parameters

| Parameter | Type   | Required | [Variable support](/docs/content/using-variables-with-content-api) | Description                                                                             |
| --------- | ------ | -------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |
| `body`    | string | Yes      | Yes                                                                | Text that appears above the quick-reply buttons.<br />Maximum length: 1,024 characters. |
| `actions` | array  | Yes      | Yes                                                                | An array that contains between 1 and 10 quick-reply buttons.                            |

### `actions` properties

For an overview of shared properties, see [Common components](/docs/content/content-types-overview#common-components).

| Property      | Supported channels                                    | Parameters                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `QUICK_REPLY` | <ul><li>WhatsApp</li><li>Facebook Messenger</li></ul> | <ul><li>**`title`**: Text that appears on the button. The same text is returned in the inbound `Body` and `ButtonText` fields when the end user selects the button. Variables are supported for in-session messages.<br />Maximum length: 20 characters.</li><li>**`id`**: A developer-defined payload that is **not** visible to the end user. The value is returned in the inbound `ButtonPayload` field when the end user selects the button. Variables are supported.<br />Maximum length: 200 characters.</li></ul> |

## Code examples and responses

Create a quick-reply template

```js
// Download the helper library from https://www.twilio.com/docs/node/install
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

// Find your Account SID at twilio.com/console
// Provision API Keys at twilio.com/console/runtime/api-keys
// and set the environment variables. See http://twil.io/secure
// For local testing, you can use your Account SID and Auth token
const accountSid = process.env.TWILIO_ACCOUNT_SID;
const apiKey = process.env.TWILIO_API_KEY;
const apiSecret = process.env.TWILIO_API_SECRET;
const client = twilio(apiKey, apiSecret, { accountSid: accountSid });

async function createContent() {
  const content = await client.content.v1.contents.create({
    friendly_name: "owl_air_qr",
    variables: {
      1: "Owl Air Customer",
    },
    language: "en",
    types: {
      "twilio/text": {
        body: "Hi, {{1}}. \n Thanks for contacting Owl Air Support. How can I help?.",
      },
      "twilio/quick-reply": {
        body: "Hi, {{1}} 👋 \nThanks for contacting Owl Air Support. How can I help?",
        actions: [
          {
            title: "Check flight status",
            id: "flightid1",
          },
          {
            title: "Check gate number",
            id: "gateid1",
          },
          {
            title: "Speak with an agent",
            id: "agentid1",
          },
        ],
      },
    },
  });

  console.log(content.dateCreated);
}

createContent();
```

```python
# Download the helper library from https://www.twilio.com/docs/python/install
import os
from twilio.rest import Client
from twilio.rest.content.v1 import ContentList

# Find your Account SID at twilio.com/console
# Provision API Keys at twilio.com/console/runtime/api-keys
# and set the environment variables. See http://twil.io/secure
# For local testing, you can use your Account SID and Auth token
api_key = os.environ["TWILIO_API_KEY"]
api_secret = os.environ["TWILIO_API_SECRET"]
account_sid = os.environ["TWILIO_ACCOUNT_SID"]
client = Client(api_key, api_secret, account_sid)

content = client.content.v1.contents.create(
    content_create_request=ContentList.ContentCreateRequest(
        {
            "friendly_name": "owl_air_qr",
            "variables": {"1": "Owl Air Customer"},
            "language": "en",
            "types": ContentList.Types(
                {
                    "twilio/text": ContentList.TwilioText(
                        {
                            "body": "Hi, {{1}}. \n Thanks for contacting Owl Air Support. How can I help?."
                        }
                    ),
                    "twilio/quick-reply": ContentList.TwilioQuickReply(
                        {
                            "body": "Hi, {{1}} 👋 \nThanks for contacting Owl Air Support. How can I help?",
                            "actions": [
                                ContentList.QuickReplyAction(
                                    {
                                        "title": "Check flight status",
                                        "id": "flightid1",
                                    }
                                ),
                                ContentList.QuickReplyAction(
                                    {
                                        "title": "Check gate number",
                                        "id": "gateid1",
                                    }
                                ),
                                ContentList.QuickReplyAction(
                                    {
                                        "title": "Speak with an agent",
                                        "id": "agentid1",
                                    }
                                ),
                            ],
                        }
                    ),
                }
            ),
        }
    )
)

print(content.date_created)
```

```csharp
// Install the C# / .NET helper library from twilio.com/docs/csharp/install

using System;
using Twilio;
using Twilio.Rest.Content.V1;
using System.Threading.Tasks;
using System.Collections.Generic;

class Program {
    public static async Task Main(string[] args) {
        // Find your Account SID at twilio.com/console
        // Provision API Keys at twilio.com/console/runtime/api-keys
        // and set the environment variables. See http://twil.io/secure
        // For local testing, you can use your Account SID and Auth token
        string apiKey = Environment.GetEnvironmentVariable("TWILIO_API_KEY");
        string apiSecret = Environment.GetEnvironmentVariable("TWILIO_API_SECRET");
        string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID");

        TwilioClient.Init(apiKey, apiSecret, accountSid);

        var content = await ContentResource.CreateAsync(
            contentCreateRequest: new ContentResource.ContentCreateRequest.Builder()
                .WithFriendlyName("owl_air_qr")
                .WithVariables(new Dictionary<string, string>() { { "1", "Owl Air Customer" } })
                .WithLanguage("en")
                .WithTypes(
                    new ContentResource.Types.Builder()
                        .WithTwilioText(
                            new ContentResource.TwilioText.Builder()
                                .WithBody(
                                    "Hi, {{1}}. \n Thanks for contacting Owl Air Support. How can I help?.")
                                .Build())
                        .WithTwilioQuickReply(
                            new ContentResource.TwilioQuickReply.Builder()
                                .WithBody(
                                    "Hi, {{1}} 👋 \nThanks for contacting Owl Air Support. How can I help?")
                                .WithActions(new List<ContentResource.QuickReplyAction> {
                                    new ContentResource.QuickReplyAction.Builder()
                                        .WithTitle("Check flight status")
                                        .WithId("flightid1")
                                        .Build(),
                                    new ContentResource.QuickReplyAction.Builder()
                                        .WithTitle("Check gate number")
                                        .WithId("gateid1")
                                        .Build(),
                                    new ContentResource.QuickReplyAction.Builder()
                                        .WithTitle("Speak with an agent")
                                        .WithId("agentid1")
                                        .Build()
                                })
                                .Build())
                        .Build())
                .Build());

        Console.WriteLine(content.DateCreated);
    }
}
```

```java
// Install the Java helper library from twilio.com/docs/java/install

import java.util.Arrays;
import java.util.HashMap;
import com.twilio.Twilio;
import com.twilio.rest.content.v1.Content;

public class Example {
    // Find your Account SID at twilio.com/console
    // Provision API Keys at twilio.com/console/runtime/api-keys
    // and set the environment variables. See http://twil.io/secure
    // For local testing, you can use your Account SID and Auth token
    public static final String API_KEY = System.getenv("TWILIO_API_KEY");
    public static final String API_SECRET = System.getenv("TWILIO_API_SECRET");
    public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID");

    public static void main(String[] args) {
        Twilio.init(API_KEY, API_SECRET, ACCOUNT_SID);

        Content.Types types = new Content.Types();
        types.setTwilioText(new HashMap<String, Object>() {
            {
                put("body", "Hi, {{1}}. \n Thanks for contacting Owl Air Support. How can I help?.");
            }
        });
        types.setTwilioQuickReply(new HashMap<String, Object>() {
            {
                put("body", "Hi, {{1}} 👋 \nThanks for contacting Owl Air Support. How can I help?");
                put("actions",
                    Arrays.asList(
                        new HashMap<String, Object>() {
                            {
                                put("title", "Check flight status");
                                put("id", "flightid1");
                            }
                        },
                        new HashMap<String, Object>() {
                            {
                                put("title", "Check gate number");
                                put("id", "gateid1");
                            }
                        },
                        new HashMap<String, Object>() {
                            {
                                put("title", "Speak with an agent");
                                put("id", "agentid1");
                            }
                        }

                        ));
            }
        });

        Content.ContentCreateRequest contentCreateRequest = new Content.ContentCreateRequest();
        contentCreateRequest.setFriendlyName("owl_air_qr");
        contentCreateRequest.setVariables(new HashMap<String, String>() {
            {
                put("1", "Owl Air Customer");
            }
        });
        contentCreateRequest.setLanguage("en");
        contentCreateRequest.setTypes(types);

        Content content = Content.creator(contentCreateRequest).create();

        System.out.println(content.getDateCreated());
    }
}
```

```go
// Download the helper library from https://www.twilio.com/docs/go/install
package main

import (
	"fmt"
	"github.com/twilio/twilio-go"
	content "github.com/twilio/twilio-go/rest/content/v1"
	"os"
)

func main() {
	// Find your Account SID at twilio.com/console
	// Provision API Keys at twilio.com/console/runtime/api-keys
	// and set the environment variables. See http://twil.io/secure
	// For local testing, you can use your Account SID and Auth token
	accountSid := os.Getenv("TWILIO_ACCOUNT_SID")
	apiKey := os.Getenv("TWILIO_API_KEY")
	apiSecret := os.Getenv("TWILIO_API_SECRET")
	client := twilio.NewRestClientWithParams(twilio.ClientParams{
		Username:   apiKey,
		Password:   apiSecret,
		AccountSid: accountSid,
	})

	params := &content.CreateContentParams{}
	params.SetContentCreateRequest(content.ContentCreateRequest{
		FriendlyName: "owl_air_qr",
		Variables: map[string]string{
			"1": "Owl Air Customer",
		},
		Language: "en",
		Types: &content.Types{
			TwilioText: &content.TwilioText{
				Body: "Hi, {{1}}. \n Thanks for contacting Owl Air Support. How can I help?.",
			},
			TwilioQuickReply: &content.TwilioQuickReply{
				Body: "Hi, {{1}} 👋 \nThanks for contacting Owl Air Support. How can I help?",
				Actions: []content.QuickReplyAction{
					content.QuickReplyAction{
						Title: "Check flight status",
						Id:    "flightid1",
					},
					content.QuickReplyAction{
						Title: "Check gate number",
						Id:    "gateid1",
					},
					content.QuickReplyAction{
						Title: "Speak with an agent",
						Id:    "agentid1",
					},
				},
			},
		},
	})

	resp, err := client.ContentV1.CreateContent(params)
	if err != nil {
		fmt.Println(err.Error())
		os.Exit(1)
	} else {
		if resp.DateCreated != nil {
			fmt.Println(*resp.DateCreated)
		} else {
			fmt.Println(resp.DateCreated)
		}
	}
}
```

```php
<?php

// Update the path below to your autoload.php,
// see https://getcomposer.org/doc/01-basic-usage.md
require_once "/path/to/vendor/autoload.php";

use Twilio\Rest\Client;
use Twilio\Rest\Content\V1\ContentModels;

// Find your Account SID at twilio.com/console
// Provision API Keys at twilio.com/console/runtime/api-keys
// and set the environment variables. See http://twil.io/secure
// For local testing, you can use your Account SID and Auth token
$apiKey = $_ENV["TWILIO_API_KEY"];
$apiSecret = $_ENV["TWILIO_API_SECRET"];
$sid = $_ENV["TWILIO_ACCOUNT_SID"];
$twilio = new Client($apiKey, $apiSecret, $sid);

$content = $twilio->content->v1->contents->create(
    ContentModels::createContentCreateRequest([
        "friendlyName" => "owl_air_qr",
        "variables" => (object) [],
        "language" => "en",
        "types" => ContentModels::createTypes([
            "twilioText" => ContentModels::createTwilioText([
                "body" =>
                    "Hi, {{1}}. \n Thanks for contacting Owl Air Support. How can I help?.",
            ]),
            "twilioQuickReply" => ContentModels::createTwilioQuickReply([
                "body" =>
                    "Hi, {{1}} 👋 \nThanks for contacting Owl Air Support. How can I help?",
                "actions" => [
                    ContentModels::createQuickReplyAction([
                        "title" => "Check flight status",
                        "id" => "flightid1",
                    ]),
                    ContentModels::createQuickReplyAction([
                        "title" => "Check gate number",
                        "id" => "gateid1",
                    ]),
                    ContentModels::createQuickReplyAction([
                        "title" => "Speak with an agent",
                        "id" => "agentid1",
                    ]),
                ],
            ]),
        ]),
    ]),
);

print $content->dateCreated?->format("r");
```

```ruby
# Download the helper library from https://www.twilio.com/docs/ruby/install
require 'twilio-ruby'

# Find your Account SID at twilio.com/console
# Provision API Keys at twilio.com/console/runtime/api-keys
# and set the environment variables. See http://twil.io/secure
# For local testing, you can use your Account SID and Auth token
api_key = ENV['TWILIO_API_KEY']
api_secret = ENV['TWILIO_API_SECRET']
account_sid = ENV['TWILIO_ACCOUNT_SID']
@client = Twilio::REST::Client.new(api_key, api_secret, account_sid)

content = @client
          .content
          .v1
          .contents
          .create(
            content_create_request: {
              'friendly_name' => 'owl_air_qr',
              'variables' => {
                '1' => 'Owl Air Customer'
              },
              'language' => 'en',
              'types' => {
                'twilio/text' => {
                  'body' => 'Hi, {{1}}. 
 Thanks for contacting Owl Air Support. How can I help?.'
                },
                'twilio/quick-reply' => {
                  'body' => 'Hi, {{1}} 👋 
Thanks for contacting Owl Air Support. How can I help?',
                  'actions' => [
                    {
                      'title' => 'Check flight status',
                      'id' => 'flightid1'
                    },
                    {
                      'title' => 'Check gate number',
                      'id' => 'gateid1'
                    },
                    {
                      'title' => 'Speak with an agent',
                      'id' => 'agentid1'
                    }
                  ]
                }
              }
            }
          )

puts content.date_created
```

```bash
# This endpoint is not currently supported by the Twilio CLI. You can open an issue to request it on https://github.com/twilio/twilio-cli/issues
  # For an alternative low-code solution, check out https://www.twilio.com/docs/openapi/using-twilio-postman-collections
```

```bash
CONTENT_CREATE_REQUEST_OBJ=$(cat << EOF
{
  "friendly_name": "owl_air_qr",
  "variables": {
    "1": "Owl Air Customer"
  },
  "language": "en",
  "types": {
    "twilio/text": {
      "body": "Hi, {{1}}. \n Thanks for contacting Owl Air Support. How can I help?."
    },
    "twilio/quick-reply": {
      "body": "Hi, {{1}} 👋 \nThanks for contacting Owl Air Support. How can I help?",
      "actions": [
        {
          "title": "Check flight status",
          "id": "flightid1"
        },
        {
          "title": "Check gate number",
          "id": "gateid1"
        },
        {
          "title": "Speak with an agent",
          "id": "agentid1"
        }
      ]
    }
  }
}
EOF
)
curl -X POST "https://content.twilio.com/v1/Content" \
--json "$CONTENT_CREATE_REQUEST_OBJ" \
-u $TWILIO_API_KEY:$TWILIO_API_SECRET
```

```json
{
  "sid": "HXaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "friendly_name": "owl_air_qr",
  "language": "en",
  "variables": {
    "1": "Owl Air Customer"
  },
  "types": {
    "twilio/text": {
      "body": "Hi, {{1}}. \n Thanks for contacting Owl Air Support. How can I help?."
    },
    "twilio/quick-reply": {
      "body": "Hi, {{1}} 👋 \nThanks for contacting Owl Air Support. How can I help?",
      "actions": [
        {
          "title": "Check flight status",
          "id": "flightid1"
        },
        {
          "title": "Check gate number",
          "id": "gateid1"
        },
        {
          "title": "Speak with an agent",
          "id": "agentid1"
        }
      ]
    }
  },
  "url": "https://content.twilio.com/v1/Content/HXaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "date_created": "2015-07-30T19:00:00Z",
  "date_updated": "2015-07-30T19:00:00Z",
  "links": {
    "approval_create": "https://content.twilio.com/v1/Content/HXaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ApprovalRequests/whatsapp",
    "approval_fetch": "https://content.twilio.com/v1/Content/HXaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ApprovalRequests"
  }
}
```
