Automatizaciones
Disparar webhook
Encola una ejecución enviando un POST a la URL pública del webhook.
POST
/
webhooks
/
{workflowId}
/
{secret}
Disparar webhook
curl --request POST \
--url https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret} \
--header 'Content-Type: application/json' \
--header 'x-ib-api-key: <api-key>' \
--data '
{
"referencia": "REC-1001",
"monto": 1250.5
}
'import requests
url = "https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}"
payload = {
"referencia": "REC-1001",
"monto": 1250.5
}
headers = {
"x-ib-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-ib-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({referencia: 'REC-1001', monto: 1250.5})
};
fetch('https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'POST',
headers: {'x-ib-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({referencia: 'REC-1001', monto: 1250.5})
};
fetch('https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}';
const options = {
method: 'POST',
headers: {'x-ib-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({referencia: 'REC-1001', monto: 1250.5})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}")
.header("x-ib-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"referencia\": \"REC-1001\",\n \"monto\": 1250.5\n}")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-ib-api-key", "<api-key>");
request.AddJsonBody("{\n \"referencia\": \"REC-1001\",\n \"monto\": 1250.5\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
using RestSharp;
var options = new RestClientOptions("https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-ib-api-key", "<api-key>");
request.AddJsonBody("{\n \"referencia\": \"REC-1001\",\n \"monto\": 1250.5\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}"
payload := strings.NewReader("{\n \"referencia\": \"REC-1001\",\n \"monto\": 1250.5\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-ib-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))
}require 'uri'
require 'net/http'
url = URI("https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-ib-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"referencia\": \"REC-1001\",\n \"monto\": 1250.5\n}"
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}",
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([
'referencia' => 'REC-1001',
'monto' => 1250.5
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-ib-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}val client = OkHttpClient()
val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n \"referencia\": \"REC-1001\",\n \"monto\": 1250.5\n}")
val request = Request.Builder()
.url("https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}")
.post(body)
.addHeader("x-ib-api-key", "<api-key>")
.addHeader("Content-Type", "application/json")
.build()
val response = client.newCall(request).execute()falseimport Foundation
let parameters = [
"referencia": "REC-1001",
"monto": 1250.5
] as [String : Any?]
let postData = try JSONSerialization.data(withJSONObject: parameters, options: [])
let url = URL(string: "https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.timeoutInterval = 10
request.allHTTPHeaderFields = [
"x-ib-api-key": "<api-key>",
"Content-Type": "application/json"
]
request.httpBody = postData
let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))$headers=@{}
$headers.Add("x-ib-api-key", "<api-key>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}' -Method POST -Headers $headers -ContentType 'application/json' -Body '{
"referencia": "REC-1001",
"monto": 1250.5
}'{
"runId": "<run-id>",
"status": "queued"
}{
"error": "Workflow not found."
}{
"error": "<string>"
}{
"error": "<string>"
}Dispara una automatización con trigger
Respuesta exitosa (
Usa
webhook. Este endpoint no usa x-ib-api-key: la autenticación es el secret de la URL.
La automatización debe estar publicada y activada.
Endpoint
POST /webhooks/{workflowId}/{secret}
Body
Envía cualquier JSON. Los campos quedan disponibles en los pasos como{{trigger.body.<campo>}}.
Ejemplo de solicitud
curl -X POST "https://api.insuranceboosters.com/api/v1/webhooks/<workflow-id>/<webhook-secret>" \
-H "Content-Type: application/json" \
-d '{
"referencia": "REC-1001",
"monto": 1250.5
}'
Respuesta exitosa (202)
{
"runId": "<run-id>",
"status": "queued"
}
runId para consultar la ejecución y sus pasos.
Errores frecuentes
| HTTP | Qué significa | Qué hacer |
|---|---|---|
400 | La automatización no tiene trigger webhook. | Usa Ejecutar ahora si es cron; los triggers de registros se disparan al crear o actualizar el registro. |
401 | El secret de la URL no coincide. | Copia el secreto actual de la automatización y vuelve a armar la URL. |
404 | El workflowId no existe. | Confirma el ID de la automatización. |
409 | No está publicada o está desactivada. | Publica y activa la automatización. |
429 | Hay demasiadas ejecuciones activas en la cuenta. | Espera a que terminen y reintenta. |
Authorizations
Path Parameters
Identificador de la automatización.
Secreto del trigger webhook. No lo compartas.
Body
application/json
The body is of type object.
Was this page helpful?
Disparar webhook
curl --request POST \
--url https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret} \
--header 'Content-Type: application/json' \
--header 'x-ib-api-key: <api-key>' \
--data '
{
"referencia": "REC-1001",
"monto": 1250.5
}
'import requests
url = "https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}"
payload = {
"referencia": "REC-1001",
"monto": 1250.5
}
headers = {
"x-ib-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-ib-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({referencia: 'REC-1001', monto: 1250.5})
};
fetch('https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const options = {
method: 'POST',
headers: {'x-ib-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({referencia: 'REC-1001', monto: 1250.5})
};
fetch('https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));const url = 'https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}';
const options = {
method: 'POST',
headers: {'x-ib-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({referencia: 'REC-1001', monto: 1250.5})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}")
.header("x-ib-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"referencia\": \"REC-1001\",\n \"monto\": 1250.5\n}")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-ib-api-key", "<api-key>");
request.AddJsonBody("{\n \"referencia\": \"REC-1001\",\n \"monto\": 1250.5\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
using RestSharp;
var options = new RestClientOptions("https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-ib-api-key", "<api-key>");
request.AddJsonBody("{\n \"referencia\": \"REC-1001\",\n \"monto\": 1250.5\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}"
payload := strings.NewReader("{\n \"referencia\": \"REC-1001\",\n \"monto\": 1250.5\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-ib-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))
}require 'uri'
require 'net/http'
url = URI("https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-ib-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"referencia\": \"REC-1001\",\n \"monto\": 1250.5\n}"
response = http.request(request)
puts response.read_body<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}",
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([
'referencia' => 'REC-1001',
'monto' => 1250.5
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-ib-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}val client = OkHttpClient()
val mediaType = MediaType.parse("application/json")
val body = RequestBody.create(mediaType, "{\n \"referencia\": \"REC-1001\",\n \"monto\": 1250.5\n}")
val request = Request.Builder()
.url("https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}")
.post(body)
.addHeader("x-ib-api-key", "<api-key>")
.addHeader("Content-Type", "application/json")
.build()
val response = client.newCall(request).execute()falseimport Foundation
let parameters = [
"referencia": "REC-1001",
"monto": 1250.5
] as [String : Any?]
let postData = try JSONSerialization.data(withJSONObject: parameters, options: [])
let url = URL(string: "https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.timeoutInterval = 10
request.allHTTPHeaderFields = [
"x-ib-api-key": "<api-key>",
"Content-Type": "application/json"
]
request.httpBody = postData
let (data, _) = try await URLSession.shared.data(for: request)
print(String(decoding: data, as: UTF8.self))$headers=@{}
$headers.Add("x-ib-api-key", "<api-key>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://api.insuranceboosters.com/api/v1/webhooks/{workflowId}/{secret}' -Method POST -Headers $headers -ContentType 'application/json' -Body '{
"referencia": "REC-1001",
"monto": 1250.5
}'{
"runId": "<run-id>",
"status": "queued"
}{
"error": "Workflow not found."
}{
"error": "<string>"
}{
"error": "<string>"
}
