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

Update Automated Message

Change an automated message, or turn it off or on. Only the fields you send change; everything else, including attachments and trigger filters you do not send, stays as stored.

Creates, updates and deletes on one account run one at a time. A request that waits more than 20 seconds for another one gets a 409 CONFLICT without changing anything; retry it. Changes made on the Fansly dashboard at the same moment are not covered.

Turning it off and on. Fansly has no separate on/off switch: send triggerType: 0 to turn the message off, and its trigger code (e.g. triggerType: 15) to turn it back on. Fansly does not remember the trigger of a turned-off message, so keep it if you want to restore it. Trigger filters are kept while the message is off.

Trigger filters must match the resulting trigger: minTipAmount / maxTipAmount / tipKeyword need 7001, subscriptionTierId a subscription trigger, and renewStreak a renew trigger. Send subscriptionTierId: null to remove the tier filter.

Attachments: omit mediaSets to keep the message's media, send mediaSets to replace it, or mediaSets: [] to remove it; lockedTexts works the same way. Other attachment types are always kept. An update that would leave no text and no attachments is rejected.

Returns the updated message.

PUT
/api/fansly/{fanslyAccount}/automated-messages/{automated_message_id}
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

automated_message_id*string

The automated message ID, from List Automated Messages.

Request Body

application/json

triggerType?integer

What sends the message, as on Create Automated Message. 0 turns the message off.

text?string

The new message text. Send an empty string for an attachment-only message.

delaySeconds?integer

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

cooldownSeconds?integer

Seconds before the same fan can receive this message again, 0–604800.

minTipAmount?integer

New tip only: the smallest tip, in Fansly's smallest unit (1000 = $1.00). Send together with maxTipAmount.

maxTipAmount?integer

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

tipKeyword?string

New tip only: text that must be in the tip message. null or an empty string removes it.

subscriptionTierId?string

Subscription triggers only: only send to subscribers of this tier. null removes the filter.

renewStreak?integer

Renew triggers only: the number of consecutive renewals that sends the message.

mediaSets?

Replacement media sets, as on Send Mass Message. [] removes all media; omit to keep the current media.

lockedTexts?

Replacement locked texts, as on Send Mass Message. [] removes them; omit to keep the current locked texts.

Response Body

application/json

curl -X PUT "https://app.fansapi.com/api/fansly/fansly_acct_XXXXXXXXXXXXXXX/automated-messages/900000000000000050" \  -H "Content-Type: application/json" \  -d '{}'
{
  "data": {
    "delay": 0,
    "cooldown": 0,
    "id": "900000000000000052",
    "triggerType": 15,
    "triggerMetadata": "{\"subscriptionTierId\":\"843584256474116096\",\"subscriptionTierName\":\"VIP\"}",
    "accountId": "800000000000000001",
    "messageTemplate": {
      "content": "Welcome! Here is a little gift.",
      "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."
    }
  }
}