Create Automated Message
Create an automated message that Fansly sends a fan when triggerType fires. Provide text, attachments, or both.
Filter the trigger with minTipAmount / maxTipAmount / tipKeyword (new tip), subscriptionTierId (the subscription triggers), and renewStreak (the renew triggers); other filter and trigger combinations are rejected.
Attachments take the same mediaSets and lockedTexts as Send Mass Message, so media can be free, gated, or paid.
Returns the created message, including its id, as List Automated Messages shows it. Fansly's create call does not return the message, so it is read back from the list afterwards.
Authorization
default Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
The Fansly Account ID
Request Body
application/json
What sends the message: 3 = new follower, 15 = new subscriber, 15002 = new gift link subscriber, 15010 = subscriber renew, 15012 = gift link subscriber renew, 7001 = new tip, 0 = disabled (created turned off).
The message text. Required unless mediaSets or lockedTexts is provided. For a tip trigger, the Fansly dashboard suggests the {amount} placeholder, e.g. "Thank you for tipping {amount} dollars!".
Seconds to wait after the trigger before sending, 0–1800. Defaults to 0.
Seconds before the same fan can receive this message again, 0–604800 (7 days).
New tip only: the smallest tip that sends the message, in Fansly's smallest unit (1000 = $1.00). Send together with maxTipAmount; use the same value for both to match one exact amount.
New tip only: the largest tip that sends the message, in Fansly's smallest unit. At least minTipAmount.
New tip only: text that must be in the tip message. Send null or an empty string for none.
Subscription triggers only (15, 15002, 15010, 15012): only send to subscribers of this tier, from List Subscription Tiers. Send null for any tier.
Renew triggers only (15010, 15012): the number of consecutive renewals after the first subscription that sends the message. 1 sends on the first renewal, 3 on the third.
Independently gated media sets, with the same fields as on Send Mass Message (mediaFiles, previews, audiences). audiences: [] makes a set free.
Locked texts, with the same fields as on Send Mass Message (text, audiences).
Response Body
application/json
curl -X POST "https://app.fansapi.com/api/fansly/fansly_acct_XXXXXXXXXXXXXXX/automated-messages" \ -H "Content-Type: application/json" \ -d '{ "triggerType": 3 }'{
"data": {
"id": "900000000000000050",
"accountId": "800000000000000001",
"triggerType": 3,
"triggerMetadata": "",
"delay": 600000,
"cooldown": 0,
"messageTemplate": {
"content": "Thank you for following.",
"attachments": [],
"senderId": "800000000000000001"
}
},
"_meta": {
"_credits": {
"used": 1,
"balance": 10055790,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 5000,
"limit_day": null,
"remaining_minute": 4999,
"remaining_day": null,
"notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
}
}
}