Queue outbound WhatsApp text, image, document, and audio. Track delivery with GET /api/messages/{id}. Successful queues return HTTP 202.

JWT sends use `https://api.actiwapi.com/api/messages`. API keys use `https://api.actiwapi.com/api/external/messages/*`. The phone field is required (country code, 8–15 digits). Optional contactId can substitute when the contact already exists.

Phone numbers and pacing

Always include the country code (for example 919876543210 or +919876543210). ActiWAPI serializes outbound traffic per session, applies minimum gaps, and humanizes delays so bursts look less like a bot.

Text: JSON { sessionId, phone, text }
Image / document / audio: multipart file or mediaUrl / mediaPath
Inbox replies use /api/chats/{threadId}/send instead of these routes

Daily message caps and monthly API request limits are on your plan. 403 LIMIT_EXCEEDED means you need an upgrade or add-on.

POST/api/messages/send-text

Send text message

Queue a text message through a connected WhatsApp session.

URL: https://api.actiwapi.com/api/messages/send-text

Auth: JWT Bearer

Headers

Header	Value	Required
Authorization	Bearer {accessToken}	Yes
Content-Type	application/json	Yes*

Request example

{
  "sessionId": "uuid",
  "phone": "919876543210",
  "text": "Hello from ActiWAPI!"
}

Code examples

curl -X POST "https://api.actiwapi.com/api/messages/send-text" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {accessToken}"
  -d '{  "sessionId": "uuid",  "phone": "919876543210",  "text": "Hello from ActiWAPI!"}'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/messages/send-text", {
    method: "POST",
    headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
    body: JSON.stringify({
  "sessionId": "uuid",
  "phone": "919876543210",
  "text": "Hello from ActiWAPI!"
}),
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/messages/send-text", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
  body: JSON.stringify({
  "sessionId": "uuid",
  "phone": "919876543210",
  "text": "Hello from ActiWAPI!"
}),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/messages/send-text",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer {accessToken}",
    },
    json={
  "sessionId": "uuid",
  "phone": "919876543210",
  "text": "Hello from ActiWAPI!"
},
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/messages/send-text")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer {accessToken}"
request.body = "{  \"sessionId\": \"uuid\",  \"phone\": \"919876543210\",  \"text\": \"Hello from ActiWAPI!\"}"

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

$ch = curl_init("https://api.actiwapi.com/api/messages/send-text");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "Authorization: Bearer {accessToken}"
    ],
    CURLOPT_POSTFIELDS => '{  "sessionId": "uuid",  "phone": "919876543210",  "text": "Hello from ActiWAPI!"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'application/json',
    'Authorization' => 'Bearer {accessToken}',
];

$response = Http::withHeaders($headers)->post("https://api.actiwapi.com/api/messages/send-text", json_decode('{  "sessionId": "uuid",  "phone": "919876543210",  "text": "Hello from ActiWAPI!"}', true));

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", "Bearer {accessToken}");

var url = "https://api.actiwapi.com/api/messages/send-text";
var content = new StringContent("""
{  "sessionId": "uuid",  "phone": "919876543210",  "text": "Hello from ActiWAPI!"}
""", Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", "Bearer {accessToken}");
});

var app = builder.Build();

app.MapPost("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var content = new StringContent("""
{  "sessionId": "uuid",  "phone": "919876543210",  "text": "Hello from ActiWAPI!"}
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/messages/send-text")
    {
        Content = content,
    };
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

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

func main() {
	payload := []byte(`{  "sessionId": "uuid",  "phone": "919876543210",  "text": "Hello from ActiWAPI!"}`)
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/messages/send-text", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Authorization", "Bearer {accessToken}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/messages/send-text"))
    .method("POST", HttpRequest.BodyPublishers.ofString("{  \"sessionId\": \"uuid\",  \"phone\": \"919876543210\",  \"text\": \"Hello from ActiWAPI!\"}"))
      .header("Content-Type", "application/json")
      .header("Authorization", "Bearer {accessToken}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example202

{
  "success": true,
  "data": {
    "id": "uuid",
    "status": "queued",
    "direction": "outbound"
  }
}

Try in Swagger UI

POST/api/messages/send-image

Send image

Send an image with optional caption. Use multipart/form-data.

URL: https://api.actiwapi.com/api/messages/send-image

Auth: JWT Bearer

Headers

Header	Value	Required
Authorization	Bearer {accessToken}	Yes
Content-Type	application/json	If JSON

Request example

Form fields:
  sessionId: uuid
  phone: 919876543210
  caption: Optional caption
  file: (binary image)

Code examples

curl -X POST "https://api.actiwapi.com/api/messages/send-image" \
  -H "Content-Type: multipart/form-data" \
  -H "Authorization: Bearer {accessToken}"
  -d 'Form fields:  sessionId: uuid  phone: 919876543210  caption: Optional caption  file: (binary image)'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/messages/send-image", {
    method: "POST",
    headers: {
    "Content-Type": "multipart/form-data",
    "Authorization": "Bearer {accessToken}"
  },
    body: JSON.stringify(Form fields:
  sessionId: uuid
  phone: 919876543210
  caption: Optional caption
  file: (binary image)),
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/messages/send-image", {
  method: "POST",
  headers: {
    "Content-Type": "multipart/form-data",
    "Authorization": "Bearer {accessToken}"
  },
  body: JSON.stringify(Form fields:
  sessionId: uuid
  phone: 919876543210
  caption: Optional caption
  file: (binary image)),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/messages/send-image",
    headers={
        "Content-Type": "multipart/form-data",
        "Authorization": "Bearer {accessToken}",
    },
    json=Form fields:
  sessionId: uuid
  phone: 919876543210
  caption: Optional caption
  file: (binary image),
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/messages/send-image")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "multipart/form-data"
request["Authorization"] = "Bearer {accessToken}"
request.body = "Form fields:  sessionId: uuid  phone: 919876543210  caption: Optional caption  file: (binary image)"

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

$ch = curl_init("https://api.actiwapi.com/api/messages/send-image");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: multipart/form-data",
    "Authorization: Bearer {accessToken}"
    ],
    CURLOPT_POSTFIELDS => 'Form fields:  sessionId: uuid  phone: 919876543210  caption: Optional caption  file: (binary image)',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'multipart/form-data',
    'Authorization' => 'Bearer {accessToken}',
];

$response = Http::withHeaders($headers)->post("https://api.actiwapi.com/api/messages/send-image", json_decode('Form fields:  sessionId: uuid  phone: 919876543210  caption: Optional caption  file: (binary image)', true));

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", "Bearer {accessToken}");

var url = "https://api.actiwapi.com/api/messages/send-image";
var content = new StringContent("""
Form fields:  sessionId: uuid  phone: 919876543210  caption: Optional caption  file: (binary image)
""", Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", "Bearer {accessToken}");
});

var app = builder.Build();

app.MapPost("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var content = new StringContent("""
Form fields:  sessionId: uuid  phone: 919876543210  caption: Optional caption  file: (binary image)
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/messages/send-image")
    {
        Content = content,
    };
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

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

func main() {
	payload := []byte(`Form fields:  sessionId: uuid  phone: 919876543210  caption: Optional caption  file: (binary image)`)
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/messages/send-image", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "multipart/form-data")
	req.Header.Set("Authorization", "Bearer {accessToken}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/messages/send-image"))
    .method("POST", HttpRequest.BodyPublishers.ofString("Form fields:  sessionId: uuid  phone: 919876543210  caption: Optional caption  file: (binary image)"))
      .header("Content-Type", "multipart/form-data")
      .header("Authorization", "Bearer {accessToken}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example202

{ "success": true, "data": { "id": "uuid", "status": "queued" } }

Try in Swagger UI

POST/api/messages/send-document

Send document

Send a PDF or other file. Multipart file, mediaUrl, or mediaPath.

URL: https://api.actiwapi.com/api/messages/send-document

Auth: JWT Bearer

Headers

Header	Value	Required
Authorization	Bearer {accessToken}	Yes
Content-Type	application/json	If JSON

Request example

Form fields:
  sessionId: uuid
  phone: 919876543210
  file: (binary)
  caption: optional

Code examples

curl -X POST "https://api.actiwapi.com/api/messages/send-document" \
  -H "Content-Type: multipart/form-data" \
  -H "Authorization: Bearer {accessToken}"
  -d 'Form fields:  sessionId: uuid  phone: 919876543210  file: (binary)  caption: optional'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/messages/send-document", {
    method: "POST",
    headers: {
    "Content-Type": "multipart/form-data",
    "Authorization": "Bearer {accessToken}"
  },
    body: JSON.stringify(Form fields:
  sessionId: uuid
  phone: 919876543210
  file: (binary)
  caption: optional),
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/messages/send-document", {
  method: "POST",
  headers: {
    "Content-Type": "multipart/form-data",
    "Authorization": "Bearer {accessToken}"
  },
  body: JSON.stringify(Form fields:
  sessionId: uuid
  phone: 919876543210
  file: (binary)
  caption: optional),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/messages/send-document",
    headers={
        "Content-Type": "multipart/form-data",
        "Authorization": "Bearer {accessToken}",
    },
    json=Form fields:
  sessionId: uuid
  phone: 919876543210
  file: (binary)
  caption: optional,
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/messages/send-document")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "multipart/form-data"
request["Authorization"] = "Bearer {accessToken}"
request.body = "Form fields:  sessionId: uuid  phone: 919876543210  file: (binary)  caption: optional"

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

$ch = curl_init("https://api.actiwapi.com/api/messages/send-document");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: multipart/form-data",
    "Authorization: Bearer {accessToken}"
    ],
    CURLOPT_POSTFIELDS => 'Form fields:  sessionId: uuid  phone: 919876543210  file: (binary)  caption: optional',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'multipart/form-data',
    'Authorization' => 'Bearer {accessToken}',
];

$response = Http::withHeaders($headers)->post("https://api.actiwapi.com/api/messages/send-document", json_decode('Form fields:  sessionId: uuid  phone: 919876543210  file: (binary)  caption: optional', true));

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", "Bearer {accessToken}");

var url = "https://api.actiwapi.com/api/messages/send-document";
var content = new StringContent("""
Form fields:  sessionId: uuid  phone: 919876543210  file: (binary)  caption: optional
""", Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", "Bearer {accessToken}");
});

var app = builder.Build();

app.MapPost("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var content = new StringContent("""
Form fields:  sessionId: uuid  phone: 919876543210  file: (binary)  caption: optional
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/messages/send-document")
    {
        Content = content,
    };
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

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

func main() {
	payload := []byte(`Form fields:  sessionId: uuid  phone: 919876543210  file: (binary)  caption: optional`)
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/messages/send-document", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "multipart/form-data")
	req.Header.Set("Authorization", "Bearer {accessToken}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/messages/send-document"))
    .method("POST", HttpRequest.BodyPublishers.ofString("Form fields:  sessionId: uuid  phone: 919876543210  file: (binary)  caption: optional"))
      .header("Content-Type", "multipart/form-data")
      .header("Authorization", "Bearer {accessToken}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example202

{ "success": true, "data": { "id": "uuid", "status": "queued" } }

Try in Swagger UI

POST/api/messages/send-audio

Send audio

Send audio or a voice note (ptt=true by default on some clients).

URL: https://api.actiwapi.com/api/messages/send-audio

Auth: JWT Bearer

Headers

Header	Value	Required
Authorization	Bearer {accessToken}	Yes
Content-Type	application/json	If JSON

Request example

Form fields:
  sessionId: uuid
  phone: 919876543210
  file: (binary audio)

Code examples

curl -X POST "https://api.actiwapi.com/api/messages/send-audio" \
  -H "Content-Type: multipart/form-data" \
  -H "Authorization: Bearer {accessToken}"
  -d 'Form fields:  sessionId: uuid  phone: 919876543210  file: (binary audio)'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/messages/send-audio", {
    method: "POST",
    headers: {
    "Content-Type": "multipart/form-data",
    "Authorization": "Bearer {accessToken}"
  },
    body: JSON.stringify(Form fields:
  sessionId: uuid
  phone: 919876543210
  file: (binary audio)),
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/messages/send-audio", {
  method: "POST",
  headers: {
    "Content-Type": "multipart/form-data",
    "Authorization": "Bearer {accessToken}"
  },
  body: JSON.stringify(Form fields:
  sessionId: uuid
  phone: 919876543210
  file: (binary audio)),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/messages/send-audio",
    headers={
        "Content-Type": "multipart/form-data",
        "Authorization": "Bearer {accessToken}",
    },
    json=Form fields:
  sessionId: uuid
  phone: 919876543210
  file: (binary audio),
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/messages/send-audio")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "multipart/form-data"
request["Authorization"] = "Bearer {accessToken}"
request.body = "Form fields:  sessionId: uuid  phone: 919876543210  file: (binary audio)"

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

$ch = curl_init("https://api.actiwapi.com/api/messages/send-audio");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: multipart/form-data",
    "Authorization: Bearer {accessToken}"
    ],
    CURLOPT_POSTFIELDS => 'Form fields:  sessionId: uuid  phone: 919876543210  file: (binary audio)',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'multipart/form-data',
    'Authorization' => 'Bearer {accessToken}',
];

$response = Http::withHeaders($headers)->post("https://api.actiwapi.com/api/messages/send-audio", json_decode('Form fields:  sessionId: uuid  phone: 919876543210  file: (binary audio)', true));

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", "Bearer {accessToken}");

var url = "https://api.actiwapi.com/api/messages/send-audio";
var content = new StringContent("""
Form fields:  sessionId: uuid  phone: 919876543210  file: (binary audio)
""", Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", "Bearer {accessToken}");
});

var app = builder.Build();

app.MapPost("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var content = new StringContent("""
Form fields:  sessionId: uuid  phone: 919876543210  file: (binary audio)
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/messages/send-audio")
    {
        Content = content,
    };
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

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

func main() {
	payload := []byte(`Form fields:  sessionId: uuid  phone: 919876543210  file: (binary audio)`)
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/messages/send-audio", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "multipart/form-data")
	req.Header.Set("Authorization", "Bearer {accessToken}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/messages/send-audio"))
    .method("POST", HttpRequest.BodyPublishers.ofString("Form fields:  sessionId: uuid  phone: 919876543210  file: (binary audio)"))
      .header("Content-Type", "multipart/form-data")
      .header("Authorization", "Bearer {accessToken}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example202

{ "success": true, "data": { "id": "uuid", "status": "queued" } }

Try in Swagger UI

GET/api/messages/{id}

Get message status

Retrieve delivery status for a sent message.

URL: https://api.actiwapi.com/api/messages/{id}

Auth: JWT Bearer

Headers

Header	Value	Required
Authorization	Bearer {accessToken}	Yes
Content-Type	application/json	Yes*

Path parameters

id — Message UUID

Code examples

curl -X GET "https://api.actiwapi.com/api/messages/{id}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {accessToken}"

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/messages/{id}", {
    method: "GET",
    headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/messages/{id}", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
});
const data = await res.json();
console.log(data);

import requests

response = requests.get(
    "https://api.actiwapi.com/api/messages/{id}",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer {accessToken}",
    },
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/messages/{id}")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Get.new(uri)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer {accessToken}"

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

$ch = curl_init("https://api.actiwapi.com/api/messages/{id}");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "Authorization: Bearer {accessToken}"
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'application/json',
    'Authorization' => 'Bearer {accessToken}',
];

$response = Http::withHeaders($headers)->get("https://api.actiwapi.com/api/messages/{id}");

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", "Bearer {accessToken}");

var url = "https://api.actiwapi.com/api/messages/{id}";
var response = await client.GetAsync(url);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("Authorization", "Bearer {accessToken}");
});

var app = builder.Build();

app.MapGet("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.actiwapi.com/api/messages/{id}");
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

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

func main() {
	req, err := http.NewRequest("GET", "https://api.actiwapi.com/api/messages/{id}", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Authorization", "Bearer {accessToken}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/messages/{id}"))
    .method("GET", HttpRequest.BodyPublishers.noBody())
      .header("Content-Type", "application/json")
      .header("Authorization", "Bearer {accessToken}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example200

{
  "success": true,
  "data": {
    "id": "uuid",
    "status": "delivered",
    "direction": "outbound",
    "remoteJid": "919876543210@s.whatsapp.net"
  }
}

Try in Swagger UI

POST/api/external/messages/send-text

Send text (API key)

Send a text message using your API key.

URL: https://api.actiwapi.com/api/external/messages/send-text

Auth: API Key

Headers

Header	Value	Required
X-API-Key	{apiKey}	Yes
Content-Type	application/json	Yes*

Request example

{
  "sessionId": "uuid",
  "phone": "919876543210",
  "text": "Hello from ActiWAPI!"
}

Code examples

curl -X POST "https://api.actiwapi.com/api/external/messages/send-text" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {apiKey}"
  -d '{  "sessionId": "uuid",  "phone": "919876543210",  "text": "Hello from ActiWAPI!"}'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/external/messages/send-text", {
    method: "POST",
    headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
    body: JSON.stringify({
  "sessionId": "uuid",
  "phone": "919876543210",
  "text": "Hello from ActiWAPI!"
}),
  });

  if (!res.ok) {
    throw new Error(await res.text());
  }

  const data = await res.json();
  console.log(data);
}

callActiwapi();

import fetch from "node-fetch";

const res = await fetch("https://api.actiwapi.com/api/external/messages/send-text", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "{apiKey}"
  },
  body: JSON.stringify({
  "sessionId": "uuid",
  "phone": "919876543210",
  "text": "Hello from ActiWAPI!"
}),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/external/messages/send-text",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": "{apiKey}",
    },
    json={
  "sessionId": "uuid",
  "phone": "919876543210",
  "text": "Hello from ActiWAPI!"
},
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/external/messages/send-text")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "application/json"
request["X-API-Key"] = "{apiKey}"
request.body = "{  \"sessionId\": \"uuid\",  \"phone\": \"919876543210\",  \"text\": \"Hello from ActiWAPI!\"}"

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

$ch = curl_init("https://api.actiwapi.com/api/external/messages/send-text");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: {apiKey}"
    ],
    CURLOPT_POSTFIELDS => '{  "sessionId": "uuid",  "phone": "919876543210",  "text": "Hello from ActiWAPI!"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'application/json',
    'X-API-Key' => '{apiKey}',
];

$response = Http::withHeaders($headers)->post("https://api.actiwapi.com/api/external/messages/send-text", json_decode('{  "sessionId": "uuid",  "phone": "919876543210",  "text": "Hello from ActiWAPI!"}', true));

$response->throw();
$data = $response->json();
dump($data);

using System.Net.Http;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");

var url = "https://api.actiwapi.com/api/external/messages/send-text";
var content = new StringContent("""
{  "sessionId": "uuid",  "phone": "919876543210",  "text": "Hello from ActiWAPI!"}
""", Encoding.UTF8, "application/json");
var response = await client.PostAsync(url, content);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

// .NET 8 — IHttpClientFactory style
using System.Net.Http.Json;
using System.Text;
using System.Text.Json;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient("Actiwapi", client =>
{
    client.DefaultRequestHeaders.TryAddWithoutValidation("X-API-Key", "{apiKey}");
});

var app = builder.Build();

app.MapPost("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var content = new StringContent("""
{  "sessionId": "uuid",  "phone": "919876543210",  "text": "Hello from ActiWAPI!"}
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/external/messages/send-text")
    {
        Content = content,
    };
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
    return Results.Content(await response.Content.ReadAsStringAsync(), "application/json");
});

app.Run();

package main

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

func main() {
	payload := []byte(`{  "sessionId": "uuid",  "phone": "919876543210",  "text": "Hello from ActiWAPI!"}`)
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/external/messages/send-text", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("X-API-Key", "{apiKey}")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.actiwapi.com/api/external/messages/send-text"))
    .method("POST", HttpRequest.BodyPublishers.ofString("{  \"sessionId\": \"uuid\",  \"phone\": \"919876543210\",  \"text\": \"Hello from ActiWAPI!\"}"))
      .header("Content-Type", "application/json")
      .header("X-API-Key", "{apiKey}")
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response example202

{ "success": true, "data": { "id": "uuid", "status": "queued" } }

Try in Swagger UI

Error codes

Failed requests return a JSON envelope with success: false and a human-readable message.

{
  "success": false,
  "message": "Validation failed",
  "errors": {
    "phone": "Valid phone number is required"
  }
}

HTTP	Code	Description
400	VALIDATION_ERROR	Request body or query failed validation.
401	UNAUTHORIZED	Missing or invalid JWT / API key.
403	FORBIDDEN	Authenticated but lacking permission or entitlement.
403	SUBSCRIPTION_INACTIVE	Action not allowed on the current plan (including Free after trial). Upgrade or wait for entitlements.
403	LIMIT_EXCEEDED	Plan limit reached (sessions, messages, API requests, etc.).
404	NOT_FOUND	Resource does not exist or is not in your account.
409	CONFLICT	Duplicate resource or invalid state transition.
429	RATE_LIMITED	Too many requests; retry after backoff.
500	INTERNAL_ERROR	Unexpected server error.
502	WHATSAPP_UNAVAILABLE	WhatsApp session disconnected or provider error.