Conversion events

Send conversion events

Sends the original Meta Conversions API payload using the stored token of a current connection in your project. First discover or create the dataset through GET or POST //dataset. No extra phone_number_id query parameter is required. The WABA in the body does not establish ownership.

Batches and test_event_code pass through unchanged. Meta status codes and response bodies are preserved. Sends are synchronous, without automatic retries. Acceptance does not guarantee ad attribution. The connection token must have the permissions and dataset access required by Meta.

POST

{dataset_id}

events

Send conversion events

curl --request POST \
  --url https://api.kapso.ai/meta/whatsapp/v24.0/{dataset_id}/events \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "data": [
    {}
  ],
  "test_event_code": "<string>"
}
'

import requests

url = "https://api.kapso.ai/meta/whatsapp/v24.0/{dataset_id}/events"

payload = {
    "data": [{}],
    "test_event_code": "<string>"
}
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({data: [{}], test_event_code: '<string>'})
};

fetch('https://api.kapso.ai/meta/whatsapp/v24.0/{dataset_id}/events', 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/meta/whatsapp/v24.0/{dataset_id}/events",
  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([
    'data' => [
        [
                
        ]
    ],
    'test_event_code' => '<string>'
  ]),
  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/meta/whatsapp/v24.0/{dataset_id}/events"

	payload := strings.NewReader("{\n  \"data\": [\n    {}\n  ],\n  \"test_event_code\": \"<string>\"\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/meta/whatsapp/v24.0/{dataset_id}/events")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": [\n    {}\n  ],\n  \"test_event_code\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.kapso.ai/meta/whatsapp/v24.0/{dataset_id}/events")

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  \"data\": [\n    {}\n  ],\n  \"test_event_code\": \"<string>\"\n}"

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

{}

Authorizations

X-API-Key

string

header

required

Project API key for authentication. This is the recommended authentication method.

Get your API key from the Kapso dashboard under Integrations > API keys.

Path Parameters

dataset_id

string

required

Dataset ID returned by WABA dataset discovery or creation

Body

application/json

data

object[]

required

test_event_code

string

Response

Meta event submission response, passed through unchanged

The response is of type object.

Send conversion events

curl --request POST \
  --url https://api.kapso.ai/meta/whatsapp/v24.0/{dataset_id}/events \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "data": [
    {}
  ],
  "test_event_code": "<string>"
}
'

import requests

url = "https://api.kapso.ai/meta/whatsapp/v24.0/{dataset_id}/events"

payload = {
    "data": [{}],
    "test_event_code": "<string>"
}
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({data: [{}], test_event_code: '<string>'})
};

fetch('https://api.kapso.ai/meta/whatsapp/v24.0/{dataset_id}/events', 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/meta/whatsapp/v24.0/{dataset_id}/events",
  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([
    'data' => [
        [
                
        ]
    ],
    'test_event_code' => '<string>'
  ]),
  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/meta/whatsapp/v24.0/{dataset_id}/events"

	payload := strings.NewReader("{\n  \"data\": [\n    {}\n  ],\n  \"test_event_code\": \"<string>\"\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/meta/whatsapp/v24.0/{dataset_id}/events")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": [\n    {}\n  ],\n  \"test_event_code\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.kapso.ai/meta/whatsapp/v24.0/{dataset_id}/events")

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  \"data\": [\n    {}\n  ],\n  \"test_event_code\": \"<string>\"\n}"

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

{}

Overview

WhatsApp API

Platform API

Workflows API

Kapso Agent API

Send conversion events

Authorizations

Path Parameters

Body

Response