POST
/
api
/
webhook
/
tweets
Receive Tweets
curl --request POST \
  --url https://api.example.com/api/webhook/tweets

​
Authentication

Pass your webhook secret as a query parameter: 
POST /api/webhook/tweets?token=YOUR_WEBHOOK_SECRET

​
Request Body

{
  "tag": "campaign-name",
  "data": [
    {
      "id": "1234567890",
      "text": "Looking for the best CRM tool",
      "author": {
        "userName": "techfounder",
        "name": "Tech Founder"
      },
      "url": "https://x.com/techfounder/status/1234567890"
    }
  ]
}

​
Response

{
  "ok": true,
  "created": 3,
  "skipped": 1
}
Duplicate tweets (matching tweet ID) are skipped. Auto-reply or auto-generate triggers automatically based on campaign settings.