curl --request POST \
--url http://localhost:3000/message/{message_id}/forward \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "6289685024051@s.whatsapp.net",
"scheduled_at": "2026-10-01T09:00:00+07:00",
"timezone": "Asia/Jakarta",
"recurrence": "once",
"weekdays": [
1,
3,
5
],
"day_of_month": 15,
"end_at": "2026-12-31T23:59:59+07:00",
"occurrence_limit": 10,
"duration": 0,
"force_reupload": false
}
'import requests
url = "http://localhost:3000/message/{message_id}/forward"
payload = {
"phone": "6289685024051@s.whatsapp.net",
"scheduled_at": "2026-10-01T09:00:00+07:00",
"timezone": "Asia/Jakarta",
"recurrence": "once",
"weekdays": [1, 3, 5],
"day_of_month": 15,
"end_at": "2026-12-31T23:59:59+07:00",
"occurrence_limit": 10,
"duration": 0,
"force_reupload": False
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
phone: '6289685024051@s.whatsapp.net',
scheduled_at: '2026-10-01T09:00:00+07:00',
timezone: 'Asia/Jakarta',
recurrence: 'once',
weekdays: [1, 3, 5],
day_of_month: 15,
end_at: '2026-12-31T23:59:59+07:00',
occurrence_limit: 10,
duration: 0,
force_reupload: false
})
};
fetch('http://localhost:3000/message/{message_id}/forward', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "3000",
CURLOPT_URL => "http://localhost:3000/message/{message_id}/forward",
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' => '6289685024051@s.whatsapp.net',
'scheduled_at' => '2026-10-01T09:00:00+07:00',
'timezone' => 'Asia/Jakarta',
'recurrence' => 'once',
'weekdays' => [
1,
3,
5
],
'day_of_month' => 15,
'end_at' => '2026-12-31T23:59:59+07:00',
'occurrence_limit' => 10,
'duration' => 0,
'force_reupload' => false
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"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 := "http://localhost:3000/message/{message_id}/forward"
payload := strings.NewReader("{\n \"phone\": \"6289685024051@s.whatsapp.net\",\n \"scheduled_at\": \"2026-10-01T09:00:00+07:00\",\n \"timezone\": \"Asia/Jakarta\",\n \"recurrence\": \"once\",\n \"weekdays\": [\n 1,\n 3,\n 5\n ],\n \"day_of_month\": 15,\n \"end_at\": \"2026-12-31T23:59:59+07:00\",\n \"occurrence_limit\": 10,\n \"duration\": 0,\n \"force_reupload\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
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("http://localhost:3000/message/{message_id}/forward")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"phone\": \"6289685024051@s.whatsapp.net\",\n \"scheduled_at\": \"2026-10-01T09:00:00+07:00\",\n \"timezone\": \"Asia/Jakarta\",\n \"recurrence\": \"once\",\n \"weekdays\": [\n 1,\n 3,\n 5\n ],\n \"day_of_month\": 15,\n \"end_at\": \"2026-12-31T23:59:59+07:00\",\n \"occurrence_limit\": 10,\n \"duration\": 0,\n \"force_reupload\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:3000/message/{message_id}/forward")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"phone\": \"6289685024051@s.whatsapp.net\",\n \"scheduled_at\": \"2026-10-01T09:00:00+07:00\",\n \"timezone\": \"Asia/Jakarta\",\n \"recurrence\": \"once\",\n \"weekdays\": [\n 1,\n 3,\n 5\n ],\n \"day_of_month\": 15,\n \"end_at\": \"2026-12-31T23:59:59+07:00\",\n \"occurrence_limit\": 10,\n \"duration\": 0,\n \"force_reupload\": false\n}"
response = http.request(request)
puts response.read_body{
"code": "SUCCESS",
"message": "Success",
"results": {
"message_id": "3EB0B430B6F8F1D0E053AC120E0A9E5C",
"status": "<feature> success ....",
"schedule_id": "0b5c3a8e-7f5d-4d6f-9d1e-2f8c1a7b9e10",
"scheduled_at": "2026-10-01T02:00:00Z",
"next_run_at": "2026-10-01T02:00:00Z"
}
}{
"code": 400,
"message": "field cannot be blank",
"results": null
}{
"code": "INTERNAL_SERVER_ERROR",
"message": "you are not loggin",
"results": null
}Forward Message
Forward a message that exists in local chat storage to another chat by message ID. Text and standard media types (image, video, video note, audio, document, sticker) are supported. Media references are reused when possible; stale refs trigger an automatic re-upload fallback. If the source media has expired on WhatsApp’s servers, the re-upload first asks the phone for the file, which needs the phone online and can take up to 30 seconds.
curl --request POST \
--url http://localhost:3000/message/{message_id}/forward \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "6289685024051@s.whatsapp.net",
"scheduled_at": "2026-10-01T09:00:00+07:00",
"timezone": "Asia/Jakarta",
"recurrence": "once",
"weekdays": [
1,
3,
5
],
"day_of_month": 15,
"end_at": "2026-12-31T23:59:59+07:00",
"occurrence_limit": 10,
"duration": 0,
"force_reupload": false
}
'import requests
url = "http://localhost:3000/message/{message_id}/forward"
payload = {
"phone": "6289685024051@s.whatsapp.net",
"scheduled_at": "2026-10-01T09:00:00+07:00",
"timezone": "Asia/Jakarta",
"recurrence": "once",
"weekdays": [1, 3, 5],
"day_of_month": 15,
"end_at": "2026-12-31T23:59:59+07:00",
"occurrence_limit": 10,
"duration": 0,
"force_reupload": False
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({
phone: '6289685024051@s.whatsapp.net',
scheduled_at: '2026-10-01T09:00:00+07:00',
timezone: 'Asia/Jakarta',
recurrence: 'once',
weekdays: [1, 3, 5],
day_of_month: 15,
end_at: '2026-12-31T23:59:59+07:00',
occurrence_limit: 10,
duration: 0,
force_reupload: false
})
};
fetch('http://localhost:3000/message/{message_id}/forward', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "3000",
CURLOPT_URL => "http://localhost:3000/message/{message_id}/forward",
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' => '6289685024051@s.whatsapp.net',
'scheduled_at' => '2026-10-01T09:00:00+07:00',
'timezone' => 'Asia/Jakarta',
'recurrence' => 'once',
'weekdays' => [
1,
3,
5
],
'day_of_month' => 15,
'end_at' => '2026-12-31T23:59:59+07:00',
'occurrence_limit' => 10,
'duration' => 0,
'force_reupload' => false
]),
CURLOPT_HTTPHEADER => [
"Authorization: Basic <encoded-value>",
"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 := "http://localhost:3000/message/{message_id}/forward"
payload := strings.NewReader("{\n \"phone\": \"6289685024051@s.whatsapp.net\",\n \"scheduled_at\": \"2026-10-01T09:00:00+07:00\",\n \"timezone\": \"Asia/Jakarta\",\n \"recurrence\": \"once\",\n \"weekdays\": [\n 1,\n 3,\n 5\n ],\n \"day_of_month\": 15,\n \"end_at\": \"2026-12-31T23:59:59+07:00\",\n \"occurrence_limit\": 10,\n \"duration\": 0,\n \"force_reupload\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Basic <encoded-value>")
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("http://localhost:3000/message/{message_id}/forward")
.header("Authorization", "Basic <encoded-value>")
.header("Content-Type", "application/json")
.body("{\n \"phone\": \"6289685024051@s.whatsapp.net\",\n \"scheduled_at\": \"2026-10-01T09:00:00+07:00\",\n \"timezone\": \"Asia/Jakarta\",\n \"recurrence\": \"once\",\n \"weekdays\": [\n 1,\n 3,\n 5\n ],\n \"day_of_month\": 15,\n \"end_at\": \"2026-12-31T23:59:59+07:00\",\n \"occurrence_limit\": 10,\n \"duration\": 0,\n \"force_reupload\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:3000/message/{message_id}/forward")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"phone\": \"6289685024051@s.whatsapp.net\",\n \"scheduled_at\": \"2026-10-01T09:00:00+07:00\",\n \"timezone\": \"Asia/Jakarta\",\n \"recurrence\": \"once\",\n \"weekdays\": [\n 1,\n 3,\n 5\n ],\n \"day_of_month\": 15,\n \"end_at\": \"2026-12-31T23:59:59+07:00\",\n \"occurrence_limit\": 10,\n \"duration\": 0,\n \"force_reupload\": false\n}"
response = http.request(request)
puts response.read_body{
"code": "SUCCESS",
"message": "Success",
"results": {
"message_id": "3EB0B430B6F8F1D0E053AC120E0A9E5C",
"status": "<feature> success ....",
"schedule_id": "0b5c3a8e-7f5d-4d6f-9d1e-2f8c1a7b9e10",
"scheduled_at": "2026-10-01T02:00:00Z",
"next_run_at": "2026-10-01T02:00:00Z"
}
}{
"code": 400,
"message": "field cannot be blank",
"results": null
}{
"code": "INTERNAL_SERVER_ERROR",
"message": "you are not loggin",
"results": null
}Authorizations
Headers
Body
Optional fields that schedule the message instead of sending it now. Set
scheduled_at to schedule; without it the message is sent immediately.
A background worker sends it at the scheduled time, retrying while the
device is offline or not logged in. Uploaded media is stored on the
server until the schedule finishes.
In multipart/form-data bodies, send weekdays as a repeated field
(weekdays=1, weekdays=3).
