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>"
}
]
}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.Headers
string
required
Your API key for authentication.
Body Parameters
string[]
required
Array of call IDs to create and send webhooks for. Each call ID must be unique within the array.
Show Array Item Properties
Show Array Item Properties
string
The unique identifier of a call to create a webhook for.
string
required
The URL where the webhook payloads should be sent.
Response
array
Array of webhook objects for each created webhook.
Show Array Item Properties
Show Array Item Properties
string
The unique identifier of the call this webhook is for.
object
The webhook payload data that was sent.
string
The URL the webhook was sent to.
string
The ID of the user/org that owns this webhook.
string
Timestamp of when the webhook was created.
array
Array of metadata objects about webhook send attempts.
array
Docs for agents: llms.txt
Was this page helpful?
⌘I