The unified inbox stores every WhatsApp conversation across your connected sessions. Use it from the dashboard or these REST endpoints to list threads, load history, reply, assign an agent, and mark a thread resolved.

Inbound and outbound messages are synced automatically when a session is connected. Threads are scoped to your workspace. Members see conversations they are allowed to access; owners and admins see the full inbox.

How the inbox works

Each thread is one contact talking to one WhatsApp session. When a message arrives or is sent, ActiWAPI upserts the thread, stores the message, and pushes a Socket.io update so the dashboard does not need to poll.

Phone numbers are stored in canonical form (digits with country code, mapped to @s.whatsapp.net). Linked-device LID identifiers are resolved to the phone JID whenever possible so inbound and outbound history stay on the same thread.

List threads with search, session filter, and status (open / resolved).
Load paginated messages for a thread, then send a text or media reply.
Assign a teammate or resolve the thread when the conversation is done.

Replying with media

Upload a file with POST /api/chats/upload first. The response includes a media URL (and path). Pass that URL on POST /api/chats/{threadId}/send together with messageType (image, document, audio, video) and optional fileName / mimetype.

Inbox replies use JWT (dashboard users). Server-to-server bots should send with the Messages or External API, which also land in the same inbox.

GET/api/chats

List threads

Paginated inbox threads for the authenticated workspace, newest activity first.

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

Auth: JWT Bearer

Headers

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

Query parameters

page — Page number (default 1)
limit — Items per page (default 20)
search — Filter by contact name or phone
sessionId — Limit to one WhatsApp session UUID
status — open, resolved, or omit for all

Code examples

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

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

require "net/http"
require "uri"

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

$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/chats";
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/chats");
    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/chats", 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/chats"))
    .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",
    "sessionId": "uuid",
    "remoteJid": "919876543210@s.whatsapp.net",
    "contactName": "Priya",
    "phone": "919876543210",
    "lastMessage": "Thanks, that worked",
    "unreadCount": 1,
    "status": "open",
    "assignedUserId": null,
    "updatedAt": "2026-09-03T12:00:00.000Z"
  }],
  "pagination": { "page": 1, "limit": 20, "total": 12, "pages": 1 }
}

Try in Swagger UI

GET/api/chats/{threadId}/messages

Get thread messages

Paginated message history for a single conversation.

URL: https://api.actiwapi.com/api/chats/{threadId}/messages

Auth: JWT Bearer

Headers

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

Path parameters

threadId — Inbox thread UUID

Query parameters

page — Page number
limit — Messages per page

Code examples

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

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

require "net/http"
require "uri"

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

$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/chats/{threadId}/messages";
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/chats/{threadId}/messages");
    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/chats/{threadId}/messages", 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/chats/{threadId}/messages"))
    .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",
    "direction": "inbound",
    "messageType": "text",
    "content": "Hi, I need help",
    "status": "delivered",
    "createdAt": "2026-09-03T12:00:00.000Z"
  }],
  "pagination": { "page": 1, "limit": 50, "total": 8, "pages": 1 }
}

Try in Swagger UI

POST/api/chats/upload

Upload inbox media

Upload a file for use in an inbox reply. Send as multipart/form-data.

URL: https://api.actiwapi.com/api/chats/upload

Auth: JWT Bearer

Headers

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

Request example

Form field: file (binary)

Code examples

curl -X POST "https://api.actiwapi.com/api/chats/upload" \
  -H "Content-Type: multipart/form-data" \
  -H "Authorization: Bearer {accessToken}"
  -d 'Form field: file (binary)'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/chats/upload", {
    method: "POST",
    headers: {
    "Content-Type": "multipart/form-data",
    "Authorization": "Bearer {accessToken}"
  },
    body: JSON.stringify(Form field: file (binary)),
  });

  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/chats/upload", {
  method: "POST",
  headers: {
    "Content-Type": "multipart/form-data",
    "Authorization": "Bearer {accessToken}"
  },
  body: JSON.stringify(Form field: file (binary)),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/chats/upload",
    headers={
        "Content-Type": "multipart/form-data",
        "Authorization": "Bearer {accessToken}",
    },
    json=Form field: file (binary),
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/chats/upload")
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 field: file (binary)"

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

$ch = curl_init("https://api.actiwapi.com/api/chats/upload");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: multipart/form-data",
    "Authorization: Bearer {accessToken}"
    ],
    CURLOPT_POSTFIELDS => 'Form field: file (binary)',
    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/chats/upload", json_decode('Form field: file (binary)', 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/chats/upload";
var content = new StringContent("""
Form field: file (binary)
""", 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 field: file (binary)
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/chats/upload")
    {
        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 field: file (binary)`)
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/chats/upload", 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/chats/upload"))
    .method("POST", HttpRequest.BodyPublishers.ofString("Form field: file (binary)"))
      .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 example200

{
  "success": true,
  "data": {
    "url": "/uploads/...",
    "path": "uploads/...",
    "fileName": "photo.jpg",
    "mimetype": "image/jpeg"
  }
}

Try in Swagger UI

POST/api/chats/{threadId}/send

Send a reply

Reply on an existing thread. Provide text and/or mediaUrl.

URL: https://api.actiwapi.com/api/chats/{threadId}/send

Auth: JWT Bearer

Headers

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

Path parameters

threadId — Inbox thread UUID

Request example

{
  "text": "We can help with that.",
  "mediaUrl": null,
  "messageType": "text",
  "fileName": null,
  "mimetype": null
}

Code examples

curl -X POST "https://api.actiwapi.com/api/chats/{threadId}/send" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {accessToken}"
  -d '{  "text": "We can help with that.",  "mediaUrl": null,  "messageType": "text",  "fileName": null,  "mimetype": null}'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/chats/{threadId}/send", {
    method: "POST",
    headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
    body: JSON.stringify({
  "text": "We can help with that.",
  "mediaUrl": null,
  "messageType": "text",
  "fileName": null,
  "mimetype": 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.actiwapi.com/api/chats/{threadId}/send", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
  body: JSON.stringify({
  "text": "We can help with that.",
  "mediaUrl": null,
  "messageType": "text",
  "fileName": null,
  "mimetype": null
}),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/chats/{threadId}/send",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer {accessToken}",
    },
    json={
  "text": "We can help with that.",
  "mediaUrl": null,
  "messageType": "text",
  "fileName": null,
  "mimetype": null
},
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/chats/{threadId}/send")
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 = "{  \"text\": \"We can help with that.\",  \"mediaUrl\": null,  \"messageType\": \"text\",  \"fileName\": null,  \"mimetype\": null}"

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

$ch = curl_init("https://api.actiwapi.com/api/chats/{threadId}/send");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "Authorization: Bearer {accessToken}"
    ],
    CURLOPT_POSTFIELDS => '{  "text": "We can help with that.",  "mediaUrl": null,  "messageType": "text",  "fileName": null,  "mimetype": null}',
    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/chats/{threadId}/send", json_decode('{  "text": "We can help with that.",  "mediaUrl": null,  "messageType": "text",  "fileName": null,  "mimetype": null}', 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/chats/{threadId}/send";
var content = new StringContent("""
{  "text": "We can help with that.",  "mediaUrl": null,  "messageType": "text",  "fileName": null,  "mimetype": 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 =>
{
    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("""
{  "text": "We can help with that.",  "mediaUrl": null,  "messageType": "text",  "fileName": null,  "mimetype": null}
""", Encoding.UTF8, "application/json");
    var request = new HttpRequestMessage(new HttpMethod("POST"), "https://api.actiwapi.com/api/chats/{threadId}/send")
    {
        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(`{  "text": "We can help with that.",  "mediaUrl": null,  "messageType": "text",  "fileName": null,  "mimetype": null}`)
	req, err := http.NewRequest("POST", "https://api.actiwapi.com/api/chats/{threadId}/send", 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/chats/{threadId}/send"))
    .method("POST", HttpRequest.BodyPublishers.ofString("{  \"text\": \"We can help with that.\",  \"mediaUrl\": null,  \"messageType\": \"text\",  \"fileName\": null,  \"mimetype\": null}"))
      .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": "queued", "direction": "outbound" }
}

Try in Swagger UI

POST/api/chats/{threadId}/assign

Assign an agent

Assign the thread to a workspace user. Pass userId null to unassign.

URL: https://api.actiwapi.com/api/chats/{threadId}/assign

Auth: JWT Bearer

Headers

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

Path parameters

threadId — Inbox thread UUID

Request example

{ "userId": "uuid" }

Code examples

curl -X POST "https://api.actiwapi.com/api/chats/{threadId}/assign" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {accessToken}"
  -d '{ "userId": "uuid" }'

async function callActiwapi() {
  const res = await fetch("https://api.actiwapi.com/api/chats/{threadId}/assign", {
    method: "POST",
    headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
    body: JSON.stringify({ "userId": "uuid" }),
  });

  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/chats/{threadId}/assign", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {accessToken}"
  },
  body: JSON.stringify({ "userId": "uuid" }),
});
const data = await res.json();
console.log(data);

import requests

response = requests.post(
    "https://api.actiwapi.com/api/chats/{threadId}/assign",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer {accessToken}",
    },
    json={ "userId": "uuid" },
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.actiwapi.com/api/chats/{threadId}/assign")
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 = "{ \"userId\": \"uuid\" }"

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

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

Try in Swagger UI

POST/api/chats/{threadId}/resolve

Resolve a thread

Mark the conversation resolved. New inbound messages typically reopen it.

URL: https://api.actiwapi.com/api/chats/{threadId}/resolve

Auth: JWT Bearer

Headers

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

Path parameters

threadId — Inbox thread UUID

Code examples

curl -X POST "https://api.actiwapi.com/api/chats/{threadId}/resolve" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {accessToken}"

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

require "net/http"
require "uri"

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

$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/chats/{threadId}/resolve";
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/chats/{threadId}/resolve");
    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/chats/{threadId}/resolve", 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/chats/{threadId}/resolve"))
    .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": { "id": "uuid", "status": "resolved" } }

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.