WhatsApp Funding

Ensure WABA funding

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

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": "4188880514714289",
    "business_portfolio_id": "1991231921410797",
    "status": "funded",
    "reason": "existing_payment_method",
    "message": "Existing Meta payment method kept.",
    "currency": "USD",
    "waba_currency": "USD",
    "last_verified_at": "2023-11-07T05:31:56Z",
    "last_checked_at": "2023-11-07T05:31:56Z",
    "paid_messages": {
      "paused": true,
      "reasons": [
        "<string>"
      ]
    },
    "operation": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "pending",
      "started_at": "2023-11-07T05:31:56Z",
      "finished_at": "2023-11-07T05:31:56Z",
      "error_kind": "<string>",
      "meta_error_code": 123
    }
  }
}

{
  "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": "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

business_portfolio_id

string

required

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

Example:

"823380597459265"

Response

Already funded, or no new run was started

data

object

required

Show child attributes

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": "4188880514714289",
    "business_portfolio_id": "1991231921410797",
    "status": "funded",
    "reason": "existing_payment_method",
    "message": "Existing Meta payment method kept.",
    "currency": "USD",
    "waba_currency": "USD",
    "last_verified_at": "2023-11-07T05:31:56Z",
    "last_checked_at": "2023-11-07T05:31:56Z",
    "paid_messages": {
      "paused": true,
      "reasons": [
        "<string>"
      ]
    },
    "operation": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "status": "pending",
      "started_at": "2023-11-07T05:31:56Z",
      "finished_at": "2023-11-07T05:31:56Z",
      "error_kind": "<string>",
      "meta_error_code": 123
    }
  }
}

{
  "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": "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

Ensure WABA funding

Authorizations

Path Parameters

Body

Response