hivoe calls your custom webhook URL, whenever your Twitter account gets a new follower.
The request method is POST and the payload is a JSON document with this schema:
{
"eventId": "cl733n77l001229mq7qzlpx37",
"twitterUserName": "Hivoe",
"twitterUserId": "22612706",
"twitterFollower": {
"id": "1454718902978719744",
"name": "Hivoe",
"screenName": "HivoeHQ",
"location": "👉",
"description": "Twitter DMs. Made easy.\\n👋 Welcome Message ✉️ Bulk DMs 🔖 Message Templates 👥 User Groups",
"url": "<https://t.co/xtjUc9KvND>",
"followersCount": 239,
"following": false,
"friendsCount": 20,
"profileImageUrl": "<https://pbs.twimg.com/profile_images/1531553671514841088/GnMTsVMQ_normal.jpg>"
}
}
The payload JSON schema in details:
| Field | Type | Content |
|---|---|---|
eventId |
text | A unique event identifier |
twitterUserName |
text | Your Twitter account name |
twitterUserId |
text | Your Twitter account id |
twitterFollower.id |
text | The follower’s Twitter account id |
twitterFollower.name |
text | The follower’s name |
twitterFollower.screenName |
text | The followers’ Twitter handle |
twitterFollower.location |
text | The follower’s location (free text — many users add other content) |
twitterFollower.description |
text | The follower’s Bio |
twitterFollower.url |
text | The follower’s URL (free text — e.g. their website or product URL) |
twitterFollower.followerCount |
number | The follower’s number of followers |
twitterFollower.following |
boolean | If you are following the follower |
twitterFollower.friendsCount |
number | The follower’s number of friends |
twitterFollower.profileImageUrl |
text | The follower’s profile image URL |
The easiest way to start is by creating a webhook on Zapier or Make (former Integromat) for free. Then you can plug other services, like:
Twitter DMs. Made Easy.