Deny Follow Request
POST
/tw-v2/interaction/deny-follow-requestDescription
Deny a pending follow request for the authenticated X account.
Usage notes
A successful request costs one API unit; failed requests are not billed. Do not retry automatically. If a timeout leaves the outcome uncertain, check the account in X before retrying manually.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| authToken | string | required | Authentication token (auth_token cookie value) for the X account whose incoming requests you manage |
| userId | string | required | Requesting user ID as a digit-only string; preserve all digits |
| proxy | string | optional | Optional proxy in format 'host:port@user:pass' |
Code Examples
const body = {
authToken: 'YOUR_AUTH_TOKEN',
userId: '1234567890'
};
const response = await fetch('https://api.tweetapi.com/tw-v2/interaction/deny-follow-request', {
method: 'POST',
headers: {
'X-API-Key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify(body)
});
const data = await response.json();
console.log(data);
Response
Success Response (200 OK)
Synthetic example:
200
{
"data": {
"id": "1234567890",
"action": "deny_follow_request",
"timestamp": "2026-01-01T00:00:00.000Z",
"success": true,
"metadata": {
"user_id": "1234567890"
}
}
}Errors
Errors return { statusCode, message } with a non-2xx HTTP status.
400
{
"statusCode": 400,
"message": "Request validation failed"
}TweetAPI is a third-party API and is not affiliated with X Corp.