Webhooks

New Follower

follower.new

Fires when a user follows the creator's profile. Followers are unpaid — they see free content and can be targeted with welcome DMs.

When it fires

A great hook for sending automated welcome messages or filtering follow growth into your CRM.

Payload

Wrapped in the standard webhook envelope (event, data, timestamp):

json · example delivery
1{
2 "event": "follower.new",
3 "data": {
4 "follower": {
5 "id": "usr_fan789",
6 "handle": "fan789",
7 "displayName": "Alex",
8 "avatarUrl": null
9 },
10 "followedAt": "2026-04-28T09:42:11Z"
11 },
12 "timestamp": "2026-04-28T09:42:12Z"
13}

data fields

FieldTypeDescription
follower.idstringID of the user who followed.
follower.handlestringPublic handle of the follower.
follower.displayNamestringDisplay name shown on the profile.
follower.avatarUrlstring | nullURL of the follower's avatar, if set.
followedAtstring (ISO 8601)Timestamp the follow occurred.