Send a scheduled message now

Read with ChatGPTRead with Claude

Send a pending scheduled message right away instead of waiting for its scheduled time. The message is handed to the scheduler, which sends it on its next run. The response shows next_send_at_utc set to the moment of the request.

• One-time message: it's sent now and doesn't go out again at its original time.
• Recurring series: this send counts as the series' next one, and the following sends are counted from now. For example, a daily series at 09:00 sent now at 15:10 continues every day at 15:10.

Only messages with status pending can be sent now. A message that already failed can't be resent: schedule a new one.

Endpoint

POST https://api.p.2chat.io/open/whatsapp/scheduled-messages/{uuid}/send-now

Authentication

Include your API key in the X-User-API-Key header. Learn more about authentication.

API cost

1API credit

Each call to this endpoint deducts 1 API credit from your plan's API credit pool.

Billing overview · How API usage is billed

Parameters

Field	In	Required	Description
uuid	path	Yes	The uuid of the scheduled message, as returned when it was scheduled or by List scheduled messages (e.g. EST83feed3c-4f8d-446b-8cbc-4efcc14ef901).

The request has no body.

Invocation

cURL

curl --location --request POST 'https://api.p.2chat.io/open/whatsapp/scheduled-messages/EST83feed3c-4f8d-446b-8cbc-4efcc14ef901/send-now' \
--header 'X-User-API-Key: your_api_key_here'

Python

import requests

uuid = "EST83feed3c-4f8d-446b-8cbc-4efcc14ef901"
url = f"https://api.p.2chat.io/open/whatsapp/scheduled-messages/{uuid}/send-now"
headers = {
    "X-User-API-Key": "your_api_key_here"
}

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

JavaScript

const axios = require('axios');

const uuid = 'EST83feed3c-4f8d-446b-8cbc-4efcc14ef901';

const response = await axios.post(`https://api.p.2chat.io/open/whatsapp/scheduled-messages/${uuid}/send-now`, null, {
    headers: {
        'X-User-API-Key': 'your_api_key_here'
    }
});

console.log(response.data);

PHP

<?php

$uuid = 'EST83feed3c-4f8d-446b-8cbc-4efcc14ef901';

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.p.2chat.io/open/whatsapp/scheduled-messages/{$uuid}/send-now",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_HTTPHEADER => array(
    'X-User-API-Key: your_api_key_here'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response

Success (HTTP 200)

The scheduled message, with next_send_at_utc set to now. The other fields are described in The scheduled message object.

{
    "data": {
        "uuid": "EST83feed3c-4f8d-446b-8cbc-4efcc14ef901",
        "status": "pending",
        "cancelled": false,
        "next_send_at_utc": "2026-11-20 20:10:05",
        "timezone": "America/New_York",
        "channel_uuid": "WPNb932ad7f-250a-4ada-86a6-c1691e00a2cb",
        "to_number": "+447700900461",
        "text": "Your weekly menu is ready!",
        "url": "https://example.com/menu.jpg",
        "template": null,
        "recurring": true,
        "repeat": {
            "unit": "weekly",
            "every": "1"
        },
        "ends": {
            "type": "occurrences",
            "occurrences": "4",
            "date": null
        },
        "sent_count": "0",
        "created_at": "2026-11-20 15:04:12"
    },
    "success": true
}

Field	Description
success	true when the message was handed to the scheduler
data	The scheduled message

Error

{
    "error": true,
    "error_message": "Payload is invalid: The scheduled message is being sent or was already sent"
}

Field	Description
error	true when the request failed
error_message	A description of what went wrong

HTTP status	error_message	Cause
400	Payload is invalid: The scheduled message is being sent or was already sent	The message is in_progress or completed.
400	Payload is invalid: The scheduled message failed and was closed; schedule a new one	The message is failed.
404	Resource Not Found: Scheduled message not found	The uuid doesn't exist on your account, or the message was cancelled.