NewFans API, previously OnlyFans API · A new name. A broader platform.
Fans API
FanslyAutomated Messages

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.

POST
/api/fansly/{fanslyAccount}/automated-messages
AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

In: header

Path Parameters

fanslyAccount*string

The Fansly Account ID

Request Body

application/json

triggerType*integer

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).

text?string

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!".

delaySeconds?integer

Seconds to wait after the trigger before sending, 0–1800. Defaults to 0.

cooldownSeconds?integer

Seconds before the same fan can receive this message again, 0–604800 (7 days).

minTipAmount?integer

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.

maxTipAmount?integer

New tip only: the largest tip that sends the message, in Fansly's smallest unit. At least minTipAmount.

tipKeyword?string

New tip only: text that must be in the tip message. Send null or an empty string for none.

subscriptionTierId?string

Subscription triggers only (15, 15002, 15010, 15012): only send to subscribers of this tier, from List Subscription Tiers. Send null for any tier.

renewStreak?integer

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.

mediaSets?

Independently gated media sets, with the same fields as on Send Mass Message (mediaFiles, previews, audiences). audiences: [] makes a set free.

lockedTexts?

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."
    }
  }
}