Developer platform

Webhooks integration guide

Create signed webhook subscriptions for real-time handoff into internal services, serverless functions, incident tools, CRMs, or any endpoint that accepts POST requests. This page lists the required credentials, setup example, mapped endpoints, and production notes.

Browse 114 endpoints Manage API keys

Base URL

https://api.trendsagi.com

114

Routes

Guides

Languages

Quick picksAds Platform Connectors Shopify BigQuery n8n Slack Webhooks

AutomationRecommended

Webhooks

Generic POST delivery for custom systems and third-party tools

Create signed webhook subscriptions for real-time handoff into internal services, serverless functions, incident tools, CRMs, or any endpoint that accepts POST requests.

Install

No SDK required. Use TrendsAGI webhook integration endpoints.

Required credentials

TRENDSAGI_API_KEY
Destination endpoint URL and downstream auth

Quick Start · bash

export TRENDSAGI_API_KEY="<TRENDSAGI_API_KEY>"
export DESTINATION_URL="https://hooks.example.com/trends"

# 1) Create a webhook subscription
CREATE_RESPONSE=$(curl -s -X POST "https://api.trendsagi.com/api/integrations/webhooks" \
  -H "Authorization: Bearer $TRENDSAGI_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"url\": \"$DESTINATION_URL\",
    \"trigger_type\": \"trend_velocity\",
    \"delivery_mode\": \"instant_stream\",
    \"threshold_value\": 50,
    \"cooldown_seconds\": 60
  }")

WEBHOOK_ID=$(echo "$CREATE_RESPONSE" | jq -r '.id')

# 2) Send a deterministic test payload
curl -X POST "https://api.trendsagi.com/api/integrations/webhooks/$WEBHOOK_ID/test" \
  -H "Authorization: Bearer $TRENDSAGI_API_KEY"

# 3) Inspect recent executions
curl -X GET "https://api.trendsagi.com/api/integrations/webhooks/$WEBHOOK_ID/executions?limit=5" \
  -H "Authorization: Bearer $TRENDSAGI_API_KEY"

# 4) Delete the webhook when finished
curl -X DELETE "https://api.trendsagi.com/api/integrations/webhooks/$WEBHOOK_ID" \
  -H "Authorization: Bearer $TRENDSAGI_API_KEY"

Run · bash

# Save as quickstart.sh
bash quickstart.sh

1. Install

Add SDK/dependency for this integration path.

2. Authenticate

Set API key and any provider-specific credentials.

3. Map Endpoints

Use mapped endpoints below to build deterministic flow.

4. Harden

Add rate-limit backoff, idempotency, and safety gates.

Loading API docs...

Webhooks integration guide

export TRENDSAGI_API_KEY="<TRENDSAGI_API_KEY>" export DESTINATION_URL="https://hooks.example.com/trends" # 1) Create a webhook subscription CREATE_RESPONSE=$(curl -s -X POST "https://api.trendsagi.com/api/integrations/webhooks" \ -H "Authorization: Bearer $TRENDSAGI_API_KEY" \ -H "Content-Type: application/json" \ -d "{ \"url\": \"$DESTINATION_URL\", \"trigger_type\": \"trend_velocity\", \"delivery_mode\": \"instant_stream\", \"threshold_value\": 50, \"cooldown_seconds\": 60 }") WEBHOOK_ID=$(echo "$CREATE_RESPONSE" | jq -r '.id') # 2) Send a deterministic test payload curl -X POST "https://api.trendsagi.com/api/integrations/webhooks/$WEBHOOK_ID/test" \ -H "Authorization: Bearer $TRENDSAGI_API_KEY" # 3) Inspect recent executions curl -X GET "https://api.trendsagi.com/api/integrations/webhooks/$WEBHOOK_ID/executions?limit=5" \ -H "Authorization: Bearer $TRENDSAGI_API_KEY" # 4) Delete the webhook when finished curl -X DELETE "https://api.trendsagi.com/api/integrations/webhooks/$WEBHOOK_ID" \ -H "Authorization: Bearer $TRENDSAGI_API_KEY"

Webhooks integration guide

Webhooks

Endpoint Mapping

Production Notes

Webhooks integration guide

Webhooks

Endpoint Mapping

Production Notes