Post Call
Create Post Call Webhook
Create and send post call webhooks for specified calls.
POST
/
v1
/
postcall
/
webhooks
/
create
Create Post Call Webhook
curl --request POST \
--url https://api.bland.ai/v1/postcall/webhooks/create \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"call_ids": [
"<string>"
],
"webhook_url": "<string>"
}
'import requests
url = "https://api.bland.ai/v1/postcall/webhooks/create"
payload = {
"call_ids": ["<string>"],
"webhook_url": "<string>"
}
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({call_ids: ['<string>'], webhook_url: '<string>'})
};
fetch('https://api.bland.ai/v1/postcall/webhooks/create', 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.bland.ai/v1/postcall/webhooks/create",
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([
'call_ids' => [
'<string>'
],
'webhook_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$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.bland.ai/v1/postcall/webhooks/create"
payload := strings.NewReader("{\n \"call_ids\": [\n \"<string>\"\n ],\n \"webhook_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("authorization", "<authorization>")
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.bland.ai/v1/postcall/webhooks/create")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"call_ids\": [\n \"<string>\"\n ],\n \"webhook_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/postcall/webhooks/create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"call_ids\": [\n \"<string>\"\n ],\n \"webhook_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"call_id": "<string>",
"payload": {},
"url": "<string>",
"user_id": "<string>",
"created_at": "<string>",
"metadata": [
{
"sent_at": "<string>",
"response_code": 123,
"response_time": "<string>",
"send_type": "<string>"
}
]
}
],
"errors": [
{
"error": "<string>",
"message": "<string>"
}
]
}Overview
Create and send post call webhooks for one or more call IDs. This endpoint allows you to create webhooks for calls that don’t already have webhooks configured. The webhooks will be sent immediately after creation to the specified webhook URL. If the call has already sent a post call webhook, this endpoint will return an error. The payload is built from the call record when you make the request. It doesn’t includeagent_dispositions, citations, corrected_transcript, or V1 dispositions, even for a call that produced them. Fields listed in your organization’s webhook_excluded_fields preference are left out, as on the regular post-call webhook.
Headers
Body Parameters
Response
Array of webhook objects for each created webhook.
Show Array Item Properties
Show Array Item Properties
Array of metadata objects about webhook send attempts.
Docs for agents: llms.txt
Was this page helpful?
⌘I
Create Post Call Webhook
curl --request POST \
--url https://api.bland.ai/v1/postcall/webhooks/create \
--header 'Content-Type: application/json' \
--header 'authorization: <authorization>' \
--data '
{
"call_ids": [
"<string>"
],
"webhook_url": "<string>"
}
'import requests
url = "https://api.bland.ai/v1/postcall/webhooks/create"
payload = {
"call_ids": ["<string>"],
"webhook_url": "<string>"
}
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({call_ids: ['<string>'], webhook_url: '<string>'})
};
fetch('https://api.bland.ai/v1/postcall/webhooks/create', 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.bland.ai/v1/postcall/webhooks/create",
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([
'call_ids' => [
'<string>'
],
'webhook_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$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.bland.ai/v1/postcall/webhooks/create"
payload := strings.NewReader("{\n \"call_ids\": [\n \"<string>\"\n ],\n \"webhook_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("authorization", "<authorization>")
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.bland.ai/v1/postcall/webhooks/create")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"call_ids\": [\n \"<string>\"\n ],\n \"webhook_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/postcall/webhooks/create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"call_ids\": [\n \"<string>\"\n ],\n \"webhook_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"call_id": "<string>",
"payload": {},
"url": "<string>",
"user_id": "<string>",
"created_at": "<string>",
"metadata": [
{
"sent_at": "<string>",
"response_code": 123,
"response_time": "<string>",
"send_type": "<string>"
}
]
}
],
"errors": [
{
"error": "<string>",
"message": "<string>"
}
]
}