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.