HTTPS callbacks for message and campaign events. Verify every delivery with HMAC-SHA256 so only ActiWAPI can call your URL.

Register a public HTTPS URL, choose events, and store the secret returned once on create. ActiWAPI retries failed deliveries. Use Socket.io for the dashboard; use webhooks for your backend.

Verify X-Webhook-Signature

Compute HMAC-SHA256 over the raw request body using the webhook secret, hex digest. Compare to the X-Webhook-Signature header with a constant-time equals. Return 2xx quickly; do heavy work asynchronously.

Canonical events: message_received, message_sent, message_delivered, message_read, message_failed, campaign_progress.
Dotted aliases such as message.received are accepted when you subscribe but payloads use underscores.
POST /api/webhooks/{id}/test sends a sample payload so you can debug your receiver.

GET/api/webhooks/events

List event types

Public list of webhook event types you can subscribe to.

URL: https://api.actiwapi.com/api/webhooks/events

Auth: None

Code examples

curl -X GET "https://api.actiwapi.com/api/webhooks/events" \
  -H "Content-Type: application/json"

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

  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/webhooks/events", {
  method: "GET",
  headers: {
    "Content-Type": "application/json"
  },
});
const data = await res.json();
console.log(data);

import requests

response = requests.get(
    "https://api.actiwapi.com/api/webhooks/events",
    headers={
        "Content-Type": "application/json",
    },
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/webhooks/events")
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"

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

$ch = curl_init("https://api.actiwapi.com/api/webhooks/events");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'application/json',
];

$response = Http::withHeaders($headers)->get("https://api.actiwapi.com/api/webhooks/events");

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

using System.Net.Http;

using var client = new HttpClient();


var url = "https://api.actiwapi.com/api/webhooks/events";
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 =>
{

});

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/webhooks/events");
    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/webhooks/events", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	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/webhooks/events"))
    .method("GET", HttpRequest.BodyPublishers.noBody())
      .header("Content-Type", "application/json")
    .build();

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

Response example200

{
  "success": true,
  "data": [
    "message_received",
    "message_sent",
    "message_delivered",
    "message_read",
    "message_failed",
    "campaign_progress"
  ]
}

Try in Swagger UI

GET/api/webhooks

List webhooks

List configured webhook endpoints.

URL: https://api.actiwapi.com/api/webhooks

Auth: JWT Bearer

Headers

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

Code examples

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

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/webhooks", {
    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/webhooks", {
  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/webhooks",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer {accessToken}",
    },
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/webhooks")
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/webhooks");
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/webhooks");

$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/webhooks";
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/webhooks");
    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/webhooks", 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/webhooks"))
    .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",
    "url": "https://api.yourapp.com/webhooks/actiwapi",
    "events": ["message_received"],
    "isActive": true
  }]
}

Try in Swagger UI

POST/api/webhooks

Create webhook

URL: https://api.actiwapi.com/api/webhooks

Auth: JWT Bearer

Headers

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

Request example

{
  "name": "Production",
  "url": "https://api.yourapp.com/webhooks/actiwapi",
  "events": ["message_received", "message_sent"]
}

Code examples

curl -X POST "https://api.actiwapi.com/api/webhooks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {accessToken}"
  -d '{  "name": "Production",  "url": "https://api.yourapp.com/webhooks/actiwapi",  "events": ["message_received", "message_sent"]}'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/webhooks", {
    method: "POST",
    headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
    body: JSON.stringify({
  "name": "Production",
  "url": "https://api.yourapp.com/webhooks/actiwapi",
  "events": ["message_received", "message_sent"]
}),
  });

  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/webhooks", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
  body: JSON.stringify({
  "name": "Production",
  "url": "https://api.yourapp.com/webhooks/actiwapi",
  "events": ["message_received", "message_sent"]
}),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/webhooks",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer {accessToken}",
    },
    json={
  "name": "Production",
  "url": "https://api.yourapp.com/webhooks/actiwapi",
  "events": ["message_received", "message_sent"]
},
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/webhooks")
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 = "{  \"name\": \"Production\",  \"url\": \"https://api.yourapp.com/webhooks/actiwapi\",  \"events\": [\"message_received\", \"message_sent\"]}"

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

$ch = curl_init("https://api.actiwapi.com/api/webhooks");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "Authorization: Bearer {accessToken}"
    ],
    CURLOPT_POSTFIELDS => '{  "name": "Production",  "url": "https://api.yourapp.com/webhooks/actiwapi",  "events": ["message_received", "message_sent"]}',
    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/webhooks", json_decode('{  "name": "Production",  "url": "https://api.yourapp.com/webhooks/actiwapi",  "events": ["message_received", "message_sent"]}', 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/webhooks";
var content = new StringContent("""
{  "name": "Production",  "url": "https://api.yourapp.com/webhooks/actiwapi",  "events": ["message_received", "message_sent"]}
""", 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("""
{  "name": "Production",  "url": "https://api.yourapp.com/webhooks/actiwapi",  "events": ["message_received", "message_sent"]}
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/webhooks")
    {
        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(`{  "name": "Production",  "url": "https://api.yourapp.com/webhooks/actiwapi",  "events": ["message_received", "message_sent"]}`)
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/webhooks", 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/webhooks"))
    .method("POST", HttpRequest.BodyPublishers.ofString("{  \"name\": \"Production\",  \"url\": \"https://api.yourapp.com/webhooks/actiwapi\",  \"events\": [\"message_received\", \"message_sent\"]}"))
      .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 example201

{ "success": true, "data": { "id": "uuid", "isActive": true, "secret": "hex-secret" } }

Try in Swagger UI

GET/api/webhooks/{id}/history

Delivery history

View delivery attempts and HTTP response codes.

URL: https://api.actiwapi.com/api/webhooks/{id}/history

Auth: JWT Bearer

Headers

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

Path parameters

id — Webhook UUID

Code examples

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

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/webhooks/{id}/history", {
    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/webhooks/{id}/history", {
  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/webhooks/{id}/history",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer {accessToken}",
    },
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/webhooks/{id}/history")
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/webhooks/{id}/history");
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/webhooks/{id}/history");

$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/webhooks/{id}/history";
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/webhooks/{id}/history");
    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/webhooks/{id}/history", 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/webhooks/{id}/history"))
    .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": [{
    "eventType": "message_received",
    "status": "success",
    "responseStatus": 200,
    "deliveredAt": "2026-05-30T10:00:00.000Z"
  }]
}

Try in Swagger UI

POST/api/webhooks/{id}/test

Send a test event

Push a sample payload to your URL so you can verify signature handling.

URL: https://api.actiwapi.com/api/webhooks/{id}/test

Auth: JWT Bearer

Headers

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

Path parameters

id — Webhook UUID

Code examples

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

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/webhooks/{id}/test", {
    method: "POST",
    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/webhooks/{id}/test", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
});
const data = await res.json();
console.log(data);

import requests

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

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/webhooks/{id}/test")
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}"

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

$ch = curl_init("https://api.actiwapi.com/api/webhooks/{id}/test");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    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/webhooks/{id}/test");

$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/webhooks/{id}/test";
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("POST"), "https://api.actiwapi.com/api/webhooks/{id}/test");
    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("POST", "https://api.actiwapi.com/api/webhooks/{id}/test", 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/webhooks/{id}/test"))
    .method("POST", 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": { "delivered": true, "responseStatus": 200 } }

Try in Swagger UI

POST/api/webhooks/{id}/deliveries/{deliveryId}/retry

Retry a delivery

Re-send a failed delivery.

URL: https://api.actiwapi.com/api/webhooks/{id}/deliveries/{deliveryId}/retry

Auth: JWT Bearer

Headers

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

Path parameters

id — Webhook UUID
deliveryId — Delivery UUID

Code examples

curl -X POST "https://api.actiwapi.com/api/webhooks/{id}/deliveries/{deliveryId}/retry" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {accessToken}"

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/webhooks/{id}/deliveries/{deliveryId}/retry", {
    method: "POST",
    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/webhooks/{id}/deliveries/{deliveryId}/retry", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/webhooks/{id}/deliveries/{deliveryId}/retry",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer {accessToken}",
    },
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/webhooks/{id}/deliveries/{deliveryId}/retry")
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}"

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

$ch = curl_init("https://api.actiwapi.com/api/webhooks/{id}/deliveries/{deliveryId}/retry");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    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/webhooks/{id}/deliveries/{deliveryId}/retry");

$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/webhooks/{id}/deliveries/{deliveryId}/retry";
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("POST"), "https://api.actiwapi.com/api/webhooks/{id}/deliveries/{deliveryId}/retry");
    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("POST", "https://api.actiwapi.com/api/webhooks/{id}/deliveries/{deliveryId}/retry", 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/webhooks/{id}/deliveries/{deliveryId}/retry"))
    .method("POST", 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": { "status": "success" } }

Try in Swagger UI

POSTyour-endpoint-url

Delivery payload shape

ActiWAPI POSTs this JSON to your URL. Verify X-Webhook-Signature = HMAC-SHA256(rawBody, secret).

URL: https://api.yourapp.com/webhooks/actiwapi

Auth: None

Request example

{
  "event": "message_received",
  "timestamp": "2026-07-17T18:05:00.000Z",
  "data": {
    "sessionId": "uuid",
    "from": "+919876543210",
    "content": "Hello",
    "messageId": "whatsapp-external-id",
    "mediaUrl": null
  }
}

Code examples

curl -X POST "https://api.yourapp.com/webhooks/actiwapi" \
  -H "Content-Type: application/json"
  -d '{  "event": "message_received",  "timestamp": "2026-07-17T18:05:00.000Z",  "data": {    "sessionId": "uuid",    "from": "+919876543210",    "content": "Hello",    "messageId": "whatsapp-external-id",    "mediaUrl": null  }}'

async function callActiwapi() {
  const res = await fetch("https://api.yourapp.com/webhooks/actiwapi", {
    method: "POST",
    headers: {
    "Content-Type": "application/json"
  },
    body: JSON.stringify({
  "event": "message_received",
  "timestamp": "2026-07-17T18:05:00.000Z",
  "data": {
    "sessionId": "uuid",
    "from": "+919876543210",
    "content": "Hello",
    "messageId": "whatsapp-external-id",
    "mediaUrl": null
  }
}),
  });

  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.yourapp.com/webhooks/actiwapi", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "event": "message_received",
  "timestamp": "2026-07-17T18:05:00.000Z",
  "data": {
    "sessionId": "uuid",
    "from": "+919876543210",
    "content": "Hello",
    "messageId": "whatsapp-external-id",
    "mediaUrl": null
  }
}),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.yourapp.com/webhooks/actiwapi",
    headers={
        "Content-Type": "application/json",
    },
    json={
  "event": "message_received",
  "timestamp": "2026-07-17T18:05:00.000Z",
  "data": {
    "sessionId": "uuid",
    "from": "+919876543210",
    "content": "Hello",
    "messageId": "whatsapp-external-id",
    "mediaUrl": null
  }
},
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.yourapp.com/webhooks/actiwapi")
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.body = "{  \"event\": \"message_received\",  \"timestamp\": \"2026-07-17T18:05:00.000Z\",  \"data\": {    \"sessionId\": \"uuid\",    \"from\": \"+919876543210\",    \"content\": \"Hello\",    \"messageId\": \"whatsapp-external-id\",    \"mediaUrl\": null  }}"

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

$ch = curl_init("https://api.yourapp.com/webhooks/actiwapi");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
    ],
    CURLOPT_POSTFIELDS => '{  "event": "message_received",  "timestamp": "2026-07-17T18:05:00.000Z",  "data": {    "sessionId": "uuid",    "from": "+919876543210",    "content": "Hello",    "messageId": "whatsapp-external-id",    "mediaUrl": null  }}',
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

<?php

use Illuminate\Support\Facades\Http;

$headers = [
    'Content-Type' => 'application/json',
];

$response = Http::withHeaders($headers)->post("https://api.yourapp.com/webhooks/actiwapi", json_decode('{  "event": "message_received",  "timestamp": "2026-07-17T18:05:00.000Z",  "data": {    "sessionId": "uuid",    "from": "+919876543210",    "content": "Hello",    "messageId": "whatsapp-external-id",    "mediaUrl": null  }}', true));

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

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

using var client = new HttpClient();


var url = "https://api.yourapp.com/webhooks/actiwapi";
var content = new StringContent("""
{  "event": "message_received",  "timestamp": "2026-07-17T18:05:00.000Z",  "data": {    "sessionId": "uuid",    "from": "+919876543210",    "content": "Hello",    "messageId": "whatsapp-external-id",    "mediaUrl": null  }}
""", 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 =>
{

});

var app = builder.Build();

app.MapPost("/proxy", async (IHttpClientFactory factory) =>
{
    var client = factory.CreateClient("Actiwapi");
    var content = new StringContent("""
{  "event": "message_received",  "timestamp": "2026-07-17T18:05:00.000Z",  "data": {    "sessionId": "uuid",    "from": "+919876543210",    "content": "Hello",    "messageId": "whatsapp-external-id",    "mediaUrl": null  }}
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.yourapp.com/webhooks/actiwapi")
    {
        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(`{  "event": "message_received",  "timestamp": "2026-07-17T18:05:00.000Z",  "data": {    "sessionId": "uuid",    "from": "+919876543210",    "content": "Hello",    "messageId": "whatsapp-external-id",    "mediaUrl": null  }}`)
	req, err := http.NewRequest("POST", "https://api.yourapp.com/webhooks/actiwapi", bytes.NewBuffer(payload))
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	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.yourapp.com/webhooks/actiwapi"))
    .method("POST", HttpRequest.BodyPublishers.ofString("{  \"event\": \"message_received\",  \"timestamp\": \"2026-07-17T18:05:00.000Z\",  \"data\": {    \"sessionId\": \"uuid\",    \"from\": \"+919876543210\",    \"content\": \"Hello\",    \"messageId\": \"whatsapp-external-id\",    \"mediaUrl\": null  }}"))
      .header("Content-Type", "application/json")
    .build();

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

Response example200

{ "ok": true }

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.