Webhook Integration for Mention

Description

Receives notifications when specified usernames are mentioned on Twitter.

Setup

Navigate to API & Integrations in your dashboard
Find the Webhook Integration for Mention section
Enter your webhook endpoint URL
Add the usernames you want to track (comma-separated)
Click Save to activate

API Configuration

Endpoint: POST https://portfolio.tigest.club/api/v1/twitter/mention_webhook

Request Payload:

{
  "usernames": "username1,username2,username3",
  "mention_webhook_url": "https://your-webhook-endpoint.com/mention",
  "organization_uuid": "3ec8486d-0d51-4bfd-b31b-60c742000247"
}

Success Response:

{
  "data": "Mention webhook created successfully",
  "success": true
}

Configuration Parameters

Parameter	Type	Required	Description	Example
`mention_webhook_url`	string	Yes	Your endpoint URL	`https://your-webhook-endpoint.com/mention`
`usernames`	string	Yes	Comma-separated Twitter usernames to monitor	`username1,username2,username3`
`organization_uuid`	string	Yes	Your organization identifier	`3ec8486d-0d51-4bfd-b31b-60c742000247`

Your Webhook Endpoint

Method: HTTP POST
Content-Type: application/json

Monitored Platform

Twitter: Real-time monitoring of mentions

Events Tracked

When any of your specified usernames are mentioned in tweets
Replies to tweets containing your usernames

Subscription Limits

Each subscription tier has limits on mention webhooks:

Check your tier limits before adding multiple mention integrations

Error Response

{
  "errors": {
    "code": 9000,
    "message": "individual tier mention_webhook limit exceeded: 2/1"
  },
  "success": false
}

Management Actions

Edit: Modify webhook URL and tracked usernames
Delete: Remove the webhook integration
Test: Send a test payload to verify endpoint

Error Handling

Ensure your webhook endpoint:

Returns HTTP 200 status for successful processing
Handles timeouts gracefully
Implements retry logic if needed

Troubleshooting

Common Issues

Webhook not receiving data: Verify your URL is accessible and returns HTTP 200
Subscription limits: Check your tier limits for mention webhooks
Invalid organization UUID: Ensure you’re using the correct organization identifier

Testing Your Integration

Use the Test button to send sample data to your endpoint and verify it’s working correctly.

Last updated: May 29, 2025

For List For Keyword