Send Interactive List

curl --request POST \
  --url https://api.flowiq.live/send-whatsapp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number": "+27123456789",
  "message_type": "interactive",
  "interactive": {
    "type": "list",
    "body": "<string>",
    "button": "<string>",
    "sections": [
      {
        "title": "<string>",
        "rows": [
          {
            "id": "<string>",
            "title": "<string>",
            "description": "<string>"
          }
        ]
      }
    ],
    "header": "<string>",
    "footer": "<string>"
  },
  "context_message_id": "wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI..."
}
'

import requests

url = "https://api.flowiq.live/send-whatsapp"

payload = {
    "phone_number": "+27123456789",
    "message_type": "interactive",
    "interactive": {
        "type": "list",
        "body": "<string>",
        "button": "<string>",
        "sections": [
            {
                "title": "<string>",
                "rows": [
                    {
                        "id": "<string>",
                        "title": "<string>",
                        "description": "<string>"
                    }
                ]
            }
        ],
        "header": "<string>",
        "footer": "<string>"
    },
    "context_message_id": "wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI..."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    phone_number: '+27123456789',
    message_type: 'interactive',
    interactive: {
      type: 'list',
      body: JSON.stringify('<string>'),
      button: '<string>',
      sections: [
        {
          title: '<string>',
          rows: [{id: '<string>', title: '<string>', description: '<string>'}]
        }
      ],
      header: '<string>',
      footer: '<string>'
    },
    context_message_id: 'wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...'
  })
};

fetch('https://api.flowiq.live/send-whatsapp', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flowiq.live/send-whatsapp",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'phone_number' => '+27123456789',
    'message_type' => 'interactive',
    'interactive' => [
        'type' => 'list',
        'body' => '<string>',
        'button' => '<string>',
        'sections' => [
                [
                                'title' => '<string>',
                                'rows' => [
                                                                [
                                                                                                                                'id' => '<string>',
                                                                                                                                'title' => '<string>',
                                                                                                                                'description' => '<string>'
                                                                ]
                                ]
                ]
        ],
        'header' => '<string>',
        'footer' => '<string>'
    ],
    'context_message_id' => 'wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flowiq.live/send-whatsapp"

	payload := strings.NewReader("{\n  \"phone_number\": \"+27123456789\",\n  \"message_type\": \"interactive\",\n  \"interactive\": {\n    \"type\": \"list\",\n    \"body\": \"<string>\",\n    \"button\": \"<string>\",\n    \"sections\": [\n      {\n        \"title\": \"<string>\",\n        \"rows\": [\n          {\n            \"id\": \"<string>\",\n            \"title\": \"<string>\",\n            \"description\": \"<string>\"\n          }\n        ]\n      }\n    ],\n    \"header\": \"<string>\",\n    \"footer\": \"<string>\"\n  },\n  \"context_message_id\": \"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.flowiq.live/send-whatsapp")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"phone_number\": \"+27123456789\",\n  \"message_type\": \"interactive\",\n  \"interactive\": {\n    \"type\": \"list\",\n    \"body\": \"<string>\",\n    \"button\": \"<string>\",\n    \"sections\": [\n      {\n        \"title\": \"<string>\",\n        \"rows\": [\n          {\n            \"id\": \"<string>\",\n            \"title\": \"<string>\",\n            \"description\": \"<string>\"\n          }\n        ]\n      }\n    ],\n    \"header\": \"<string>\",\n    \"footer\": \"<string>\"\n  },\n  \"context_message_id\": \"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flowiq.live/send-whatsapp")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"phone_number\": \"+27123456789\",\n  \"message_type\": \"interactive\",\n  \"interactive\": {\n    \"type\": \"list\",\n    \"body\": \"<string>\",\n    \"button\": \"<string>\",\n    \"sections\": [\n      {\n        \"title\": \"<string>\",\n        \"rows\": [\n          {\n            \"id\": \"<string>\",\n            \"title\": \"<string>\",\n            \"description\": \"<string>\"\n          }\n        ]\n      }\n    ],\n    \"header\": \"<string>\",\n    \"footer\": \"<string>\"\n  },\n  \"context_message_id\": \"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Message sent successfully",
  "data": {
    "message_id": "wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...",
    "recipient": "27123456789",
    "message_type": "<string>"
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

POST

send-whatsapp

Send Interactive List

curl --request POST \
  --url https://api.flowiq.live/send-whatsapp \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "phone_number": "+27123456789",
  "message_type": "interactive",
  "interactive": {
    "type": "list",
    "body": "<string>",
    "button": "<string>",
    "sections": [
      {
        "title": "<string>",
        "rows": [
          {
            "id": "<string>",
            "title": "<string>",
            "description": "<string>"
          }
        ]
      }
    ],
    "header": "<string>",
    "footer": "<string>"
  },
  "context_message_id": "wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI..."
}
'

import requests

url = "https://api.flowiq.live/send-whatsapp"

payload = {
    "phone_number": "+27123456789",
    "message_type": "interactive",
    "interactive": {
        "type": "list",
        "body": "<string>",
        "button": "<string>",
        "sections": [
            {
                "title": "<string>",
                "rows": [
                    {
                        "id": "<string>",
                        "title": "<string>",
                        "description": "<string>"
                    }
                ]
            }
        ],
        "header": "<string>",
        "footer": "<string>"
    },
    "context_message_id": "wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI..."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    phone_number: '+27123456789',
    message_type: 'interactive',
    interactive: {
      type: 'list',
      body: JSON.stringify('<string>'),
      button: '<string>',
      sections: [
        {
          title: '<string>',
          rows: [{id: '<string>', title: '<string>', description: '<string>'}]
        }
      ],
      header: '<string>',
      footer: '<string>'
    },
    context_message_id: 'wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...'
  })
};

fetch('https://api.flowiq.live/send-whatsapp', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flowiq.live/send-whatsapp",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'phone_number' => '+27123456789',
    'message_type' => 'interactive',
    'interactive' => [
        'type' => 'list',
        'body' => '<string>',
        'button' => '<string>',
        'sections' => [
                [
                                'title' => '<string>',
                                'rows' => [
                                                                [
                                                                                                                                'id' => '<string>',
                                                                                                                                'title' => '<string>',
                                                                                                                                'description' => '<string>'
                                                                ]
                                ]
                ]
        ],
        'header' => '<string>',
        'footer' => '<string>'
    ],
    'context_message_id' => 'wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flowiq.live/send-whatsapp"

	payload := strings.NewReader("{\n  \"phone_number\": \"+27123456789\",\n  \"message_type\": \"interactive\",\n  \"interactive\": {\n    \"type\": \"list\",\n    \"body\": \"<string>\",\n    \"button\": \"<string>\",\n    \"sections\": [\n      {\n        \"title\": \"<string>\",\n        \"rows\": [\n          {\n            \"id\": \"<string>\",\n            \"title\": \"<string>\",\n            \"description\": \"<string>\"\n          }\n        ]\n      }\n    ],\n    \"header\": \"<string>\",\n    \"footer\": \"<string>\"\n  },\n  \"context_message_id\": \"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.flowiq.live/send-whatsapp")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"phone_number\": \"+27123456789\",\n  \"message_type\": \"interactive\",\n  \"interactive\": {\n    \"type\": \"list\",\n    \"body\": \"<string>\",\n    \"button\": \"<string>\",\n    \"sections\": [\n      {\n        \"title\": \"<string>\",\n        \"rows\": [\n          {\n            \"id\": \"<string>\",\n            \"title\": \"<string>\",\n            \"description\": \"<string>\"\n          }\n        ]\n      }\n    ],\n    \"header\": \"<string>\",\n    \"footer\": \"<string>\"\n  },\n  \"context_message_id\": \"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flowiq.live/send-whatsapp")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"phone_number\": \"+27123456789\",\n  \"message_type\": \"interactive\",\n  \"interactive\": {\n    \"type\": \"list\",\n    \"body\": \"<string>\",\n    \"button\": \"<string>\",\n    \"sections\": [\n      {\n        \"title\": \"<string>\",\n        \"rows\": [\n          {\n            \"id\": \"<string>\",\n            \"title\": \"<string>\",\n            \"description\": \"<string>\"\n          }\n        ]\n      }\n    ],\n    \"header\": \"<string>\",\n    \"footer\": \"<string>\"\n  },\n  \"context_message_id\": \"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Message sent successfully",
  "data": {
    "message_id": "wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...",
    "recipient": "27123456789",
    "message_type": "<string>"
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

Basic Usage

curl -X POST "https://api.flowiq.live/send-whatsapp" \
  -H "Authorization: Bearer fiq_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+27123456789",
    "message_type": "interactive",
    "interactive": {
      "type": "list",
      "header": "Our Menu",
      "body": "Please select from our available options:",
      "footer": "Tap the button below to view options",
      "button": "View Menu",
      "sections": [
        {
          "title": "Main Dishes",
          "rows": [
            { "id": "burger", "title": "Burger", "description": "Beef patty with cheese" },
            { "id": "pizza", "title": "Pizza", "description": "Margherita or Pepperoni" }
          ]
        },
        {
          "title": "Drinks",
          "rows": [
            { "id": "cola", "title": "Cola", "description": "500ml bottle" },
            { "id": "water", "title": "Water", "description": "Still or sparkling" }
          ]
        }
      ]
    }
  }'

Request Body

Field	Type	Required	Description
`phone_number`	string	Yes	Recipient phone number with country code
`message_type`	string	Yes	Must be `"interactive"`
`interactive.type`	string	Yes	Must be `"list"`
`interactive.body`	string	Yes	Main message text (max 1024 chars)
`interactive.button`	string	Yes	Menu button label (max 20 chars)
`interactive.header`	string	No	Header text (max 60 chars)
`interactive.footer`	string	No	Footer text (max 60 chars)
`interactive.sections`	array	Yes	Array of sections — max 10
`interactive.sections[].title`	string	No	Section heading (max 24 chars)
`interactive.sections[].rows`	array	Yes	Rows within the section
`interactive.sections[].rows[].id`	string	Yes	Unique row ID returned on selection
`interactive.sections[].rows[].title`	string	Yes	Row label (max 24 chars)
`interactive.sections[].rows[].description`	string	No	Row description (max 72 chars)
`context_message_id`	string	No	WhatsApp message ID to reply to

Supports up to 10 sections with up to 10 rows each. Use lists when you have more than 3 options — buttons max out at 3.

{
  "phone_number": "+27123456789",
  "message_type": "interactive",
  "interactive": {
    "type": "list",
    "body": "Please select a support category:",
    "button": "View Options",
    "sections": [
      {
        "title": "Support",
        "rows": [
          { "id": "billing", "title": "Billing", "description": "Payment and invoice queries" },
          { "id": "technical", "title": "Technical", "description": "App or integration issues" }
        ]
      }
    ]
  }
}

Response

Success (200)

{
  "success": true,
  "message": "Message sent successfully",
  "data": {
    "message_id": "wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI...",
    "recipient": "27123456789",
    "message_type": "interactive"
  }
}

Error: Missing Required Field (400)

{
  "error": "Missing required field",
  "message": "interactive.body, interactive.button, and interactive.sections are required for list messages"
}

Integration Example

async function sendInteractiveList(apiKey, phoneNumber, interactive) {
  const response = await fetch(
    `https://api.flowiq.live/send-whatsapp`,
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${apiKey}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ phone_number: phoneNumber, message_type: "interactive", interactive }),
    }
  );
  const data = await response.json();
  if (!response.ok) throw new Error(data.message);
  return data;
}

Authorizations

Authorization

string

header

required

Bearer token for authentication. Format: Bearer YOUR_BEARER_TOKEN

Body

application/json

phone_number

string

required

Recipient phone number with country code

Example:

"+27123456789"

message_type

enum<string>

required

Must be "interactive"

Available options:

interactive

Example:

"interactive"

interactive

object

required

Interactive list message configuration

Show child attributes

context_message_id

string

WhatsApp message ID to reply to

Example:

"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI..."

Response

Message sent successfully

success

boolean

Example:

true

message

string

Example:

"Message sent successfully"

data

object

Show child attributes

Send Interactive Buttons Send Reaction

Getting Started

Webhooks

Endpoints

Send Interactive List

Basic Usage

Request Body

Response

Success (200)

Error: Missing Required Field (400)

Integration Example

Authorizations

Body

Response

​Basic Usage

​Request Body

​Response

​Success (200)

​Error: Missing Required Field (400)

​Integration Example

Authorizations

Body

Response

Basic Usage

Request Body

Response

Success (200)

Error: Missing Required Field (400)

Integration Example