WhatsApp Funding

Activate or ensure WABA funding

Connected accounts: for a production WABA connected through Kapso’s default Meta app or an eligible hosted MPS, send no body. Kapso synchronously switches the entire WABA to Kapso credits and returns the funding object with an activation result. 200 with activation.success: true means verified activation; a customer-managed resolution can return 200 with activation.success: false. Failures before an attempt starts return {error, error_kind}; completed attempts return the funding envelope with activation. After a timeout, read funding before retrying.

External multi-partner solution accounts: send business_portfolio_id. Verifies an external multi-partner solution account with Meta and ensures Kapso funding for it, without waiting for the Meta association webhook. Use it after Embedded Signup completes.

Your project must have exactly one active external multi-partner solution; you cannot select a solution or project, set the WABA currency, or supply a token. When the membership is unknown, Kapso reads the WABA through that solution and verifies its owning portfolio before recording the association. Financial setup then runs in the background.

202 means a funding run is pending or running - it is not confirmation that the account is funded. Poll GET /whatsapp/accounts/{waba_id}/funding until the run reaches a terminal state and the funding status is funded. 200 is returned when the account is already funded or when no new run was started.

Idempotent on desired state, with no Idempotency-Key: repeated calls reuse an in-progress run, and a terminal run is returned during a 30 second cooldown. After the cooldown a new run is started. The endpoint never resumes an explicitly disabled portfolio, a removed membership, or a revoked attachment - those stay explicit workflows.

POST

accounts

{waba_id}

funding

Activate or ensure WABA funding

curl --request POST \
  --url https://api.kapso.ai/platform/v1/whatsapp/accounts/{waba_id}/funding \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "business_portfolio_id": "823380597459265"
}
'

import requests

url = "https://api.kapso.ai/platform/v1/whatsapp/accounts/{waba_id}/funding"

payload = { "business_portfolio_id": "823380597459265" }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({business_portfolio_id: '823380597459265'})
};

fetch('https://api.kapso.ai/platform/v1/whatsapp/accounts/{waba_id}/funding', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.kapso.ai/platform/v1/whatsapp/accounts/{waba_id}/funding",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'business_portfolio_id' => '823380597459265'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.kapso.ai/platform/v1/whatsapp/accounts/{waba_id}/funding"

	payload := strings.NewReader("{\n  \"business_portfolio_id\": \"823380597459265\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.kapso.ai/platform/v1/whatsapp/accounts/{waba_id}/funding")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"business_portfolio_id\": \"823380597459265\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.kapso.ai/platform/v1/whatsapp/accounts/{waba_id}/funding")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"business_portfolio_id\": \"823380597459265\"\n}"

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

{
  "data": {
    "waba_id": "109537945127015",
    "business_portfolio_id": "823380597459265",
    "status": "funded",
    "reason": null,
    "message": null,
    "currency": "USD",
    "waba_currency": "USD",
    "last_verified_at": "2026-11-03T12:00:00Z",
    "last_checked_at": "2026-11-03T12:00:00Z",
    "paid_messages": {
      "paused": false,
      "reasons": []
    },
    "operation": null,
    "activation": {
      "success": true,
      "resolution": null,
      "error_kind": null,
      "message": "Kapso funding is verified."
    }
  }
}

{
  "data": {
    "waba_id": "109537945127015",
    "business_portfolio_id": "823380597459265",
    "status": "not_funded",
    "reason": null,
    "message": "Kapso funding is not active.",
    "currency": "USD",
    "waba_currency": "USD",
    "last_verified_at": null,
    "last_checked_at": null,
    "paid_messages": {
      "paused": false,
      "reasons": []
    },
    "operation": {
      "id": "ad0d68c2-3a0d-43d9-aa41-d7bd1bc6792b",
      "status": "pending",
      "started_at": "2026-09-15T01:00:00Z",
      "finished_at": null,
      "error_kind": null,
      "meta_error_code": null
    }
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>",
  "error_kind": "<string>"
}

{
  "error": "<string>",
  "error_kind": "<string>"
}

{
  "error": "Meta could not verify account access. Retry later or contact support.",
  "error_kind": "meta_unavailable",
  "meta_error_code": null,
  "meta_trace_id": null
}

{
  "error": "<string>"
}

Authorizations

X-API-Key

string

header

required

Path Parameters

waba_id

string

required

Meta WhatsApp Business Account ID.

Body

application/json

Required for external multi-partner solution accounts. Omit for connected accounts.

business_portfolio_id

string

required

Meta Business Portfolio ID that owns the WABA. Digits only.

Example:

"823380597459265"

Response

External accounts: already funded, or no new run was started. Connected accounts: activation result in activation.

Option 1
Option 2

data

object

required

Show child attributes

Activate or ensure WABA funding

curl --request POST \
  --url https://api.kapso.ai/platform/v1/whatsapp/accounts/{waba_id}/funding \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "business_portfolio_id": "823380597459265"
}
'

import requests

url = "https://api.kapso.ai/platform/v1/whatsapp/accounts/{waba_id}/funding"

payload = { "business_portfolio_id": "823380597459265" }
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({business_portfolio_id: '823380597459265'})
};

fetch('https://api.kapso.ai/platform/v1/whatsapp/accounts/{waba_id}/funding', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.kapso.ai/platform/v1/whatsapp/accounts/{waba_id}/funding",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'business_portfolio_id' => '823380597459265'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.kapso.ai/platform/v1/whatsapp/accounts/{waba_id}/funding"

	payload := strings.NewReader("{\n  \"business_portfolio_id\": \"823380597459265\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.kapso.ai/platform/v1/whatsapp/accounts/{waba_id}/funding")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"business_portfolio_id\": \"823380597459265\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.kapso.ai/platform/v1/whatsapp/accounts/{waba_id}/funding")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"business_portfolio_id\": \"823380597459265\"\n}"

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

{
  "data": {
    "waba_id": "109537945127015",
    "business_portfolio_id": "823380597459265",
    "status": "funded",
    "reason": null,
    "message": null,
    "currency": "USD",
    "waba_currency": "USD",
    "last_verified_at": "2026-11-03T12:00:00Z",
    "last_checked_at": "2026-11-03T12:00:00Z",
    "paid_messages": {
      "paused": false,
      "reasons": []
    },
    "operation": null,
    "activation": {
      "success": true,
      "resolution": null,
      "error_kind": null,
      "message": "Kapso funding is verified."
    }
  }
}

{
  "data": {
    "waba_id": "109537945127015",
    "business_portfolio_id": "823380597459265",
    "status": "not_funded",
    "reason": null,
    "message": "Kapso funding is not active.",
    "currency": "USD",
    "waba_currency": "USD",
    "last_verified_at": null,
    "last_checked_at": null,
    "paid_messages": {
      "paused": false,
      "reasons": []
    },
    "operation": {
      "id": "ad0d68c2-3a0d-43d9-aa41-d7bd1bc6792b",
      "status": "pending",
      "started_at": "2026-09-15T01:00:00Z",
      "finished_at": null,
      "error_kind": null,
      "meta_error_code": null
    }
  }
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>",
  "error_kind": "<string>"
}

{
  "error": "<string>",
  "error_kind": "<string>"
}

{
  "error": "Meta could not verify account access. Retry later or contact support.",
  "error_kind": "meta_unavailable",
  "meta_error_code": null,
  "meta_trace_id": null
}

{
  "error": "<string>"
}

Overview

WhatsApp API

Platform API

Workflows API

Kapso Agent API

Activate or ensure WABA funding

Authorizations

Path Parameters

Body

Response