Webhooks

Receive a signed HTTP POST every time something happens in a project, with no polling. Webhooks power the LLM Pulse connectors for Zapier, Make and n8n, and work with any custom backend. Available on the Scale plan and above.

Event types: mention.created, competitor_mention.created, citation.created, prompt_execution.completed, sentiment.negative_detected (negative or very negative brand sentiment), recommendation.completed, intelligence_task.completed.
Security: every delivery carries X-LLMPulse-Event, X-LLMPulse-Delivery (unique id) and X-LLMPulse-Signature (sha256=<hex>, HMAC-SHA256 of the raw body computed with the subscription secret). Verify the signature to authenticate deliveries.
Delivery: a 2xx response acknowledges the event; anything else is retried 5 times with exponential backoff. Subscriptions auto-disable after 20 consecutive failed deliveries.

POST`/webhooks`

Create a subscription. Idempotent: re-posting the same project + event + URL returns the existing subscription. The signing secret (whsec_...) is only returned by this endpoint, store it to verify delivery signatures. Requires a read_write scope key.

Body (JSON):

project_idrequired
event_typerequired, see event list above
target_urlrequired, public HTTPS URL; private IPs, localhost and internal hostnames are rejected

Max 100 active subscriptions per account.

GET`/webhooks`

List active subscriptions for the account. Items match the create response without the secret.

Params:

project_idoptional filter
page
per_pagemax 100

DELETE`/webhooks/:id`

Delete a subscription. The target URL stops receiving events immediately. Requires a read_write scope key.

Path:

:idsubscription id

Returns ERR_NOT_FOUND for subscriptions that do not belong to the account.

GET`/webhooks/sample/:event_type`

Up to 3 example event payloads for the event type, built from the project''s most recent real data (or a static sample when the project has no data yet). Used by integration editors such as the Zapier sample loader. Also available as the MCP tool get_webhook_sample.

Params:

:event_typepath
project_idrequired

Code Examples

Download: OpenAPI Swagger Postman

Ask AI: Open in ChatGPT Open in Claude View as Markdown

Language

Request

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"project_id":"PROJECT_ID","event_type":"mention.created","target_url":"https://example.com/webhooks/llmpulse"}' \
  "https://api.llmpulse.ai/api/v1/webhooks"

const response = await fetch("https://api.llmpulse.ai/api/v1/webhooks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"project_id":"PROJECT_ID","event_type":"mention.created","target_url":"https://example.com/webhooks/llmpulse"})
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.llmpulse.ai/api/v1/webhooks",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"project_id":"PROJECT_ID","event_type":"mention.created","target_url":"https://example.com/webhooks/llmpulse"}
)
data = response.json()

require 'httparty'

response = HTTParty.post(
  "https://api.llmpulse.ai/api/v1/webhooks",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" },
  body: {"project_id":"PROJECT_ID","event_type":"mention.created","target_url":"https://example.com/webhooks/llmpulse"}
)
data = response.parsed_response

req, _ := http.NewRequest("POST", "https://api.llmpulse.ai/api/v1/webhooks", strings.NewReader(`{"project_id":"PROJECT_ID","event_type":"mention.created","target_url":"https://example.com/webhooks/llmpulse"}`))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('POST', 'https://api.llmpulse.ai/api/v1/webhooks', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => {"project_id":"PROJECT_ID","event_type":"mention.created","target_url":"https://example.com/webhooks/llmpulse"}
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/webhooks"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{\"project_id\":\"PROJECT_ID\",\"event_type\":\"mention.created\",\"target_url\":\"https://example.com/webhooks/llmpulse\"}"))
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/webhooks?project_id=PROJECT_ID"

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/webhooks?project_id=PROJECT_ID",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/webhooks?project_id=PROJECT_ID", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/webhooks?project_id=PROJECT_ID', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/webhooks?project_id=PROJECT_ID"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X DELETE -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/webhooks/123"

req, _ := http.NewRequest("DELETE", "https://api.llmpulse.ai/api/v1/webhooks/123", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('DELETE', 'https://api.llmpulse.ai/api/v1/webhooks/123', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/webhooks/123"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .DELETE()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/webhooks/sample/mention.created?project_id=PROJECT_ID"

const response = await fetch("https://api.llmpulse.ai/api/v1/webhooks/sample/mention.created?project_id=PROJECT_ID", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/webhooks/sample/mention.created?project_id=PROJECT_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/webhooks/sample/mention.created?project_id=PROJECT_ID",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/webhooks/sample/mention.created?project_id=PROJECT_ID", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/webhooks/sample/mention.created?project_id=PROJECT_ID', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.llmpulse.ai/api/v1/webhooks/sample/mention.created?project_id=PROJECT_ID"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());