Instead of polling, you can push tweets to GenX via webhooks for instant processing.

​
Webhook Endpoints

GenX exposes two webhook endpoints:

​
Primary endpoint

POST https://api.genx.zone/api/webhook/tweets?token=YOUR_WEBHOOK_SECRET

​
Legacy endpoint (IRIS compatible)

POST https://api.genx.zone/receive?token=YOUR_WEBHOOK_SECRET

​
Authentication

Include your webhook secret as a query parameter: 
?token=YOUR_WEBHOOK_SECRET
Find your webhook secret in Settings. It’s auto-generated when your account is created.

​
Payload Format

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

​
Fields

FieldRequiredDescription
tagNoCampaign name to associate with
dataYesArray of tweet objects
data[].idYesTweet ID
data[].textYesTweet text content
data[].author.userNameYesAuthor’s Twitter handle
data[].author.nameNoAuthor’s display name
data[].urlNoFull tweet URL

​
Auto-Processing

When a webhook delivers tweets:
  1. Conversations are created automatically
  2. If the matched campaign has auto-reply enabled, replies are generated and posted
  3. If auto-generate is enabled, drafts are created for review
  4. Campaign statistics are updated

​
Response

{
  "ok": true,
  "created": 3,
  "skipped": 1
}