Automations

Resume an automation

POST/v1/automations/{automation_id}/resume

Turns a paused automation back on: it fires again on events that happen from now on (never on past ones). Only a paused one: a draft or an archived automation is turned on from the app. It sends real messages: confirm with the user first.

Required scopewrite:automations

Rate limit30 requests per minute

curl -X POST 'https://api.fansquare.so/v1/automations/8f17cc65-760b-4c46-a945-b9395948cb15/resume' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Fansquare-Version: Amethyste"

{
  "id": "8f17cc65-760b-4c46-a945-b9395948cb15",
  "creator_id": "m81IhLxdhzDGYs54rNp2",
  "name": "Lena",
  "status": "active",
  "trigger": {
    "type": "new_subscriber",
    "days_before": 1,
    "send_time_local": "string",
    "timezone": "Europe/Paris",
    "min_amount_cents": 4900,
    "online_window_start": "string",
    "online_window_end": "string"
  },
  "stats": {
    "triggered_count": 12,
    "fans_contacted": 1,
    "failed_count": 2,
    "revenue_cents": 4900,
    "purchases": 12,
    "replies": 12,
    "reads": 12,
    "last_triggered_at": "2026-10-12T21:14:00.000Z"
  },
  "created_at": "2026-10-12T21:14:00.000Z",
  "activated_at": "2026-10-12T21:14:00.000Z",
  "messages": [
    {
      "text": "string",
      "media_ids": [
        "b12eacb2-afea-4959-a0d0-b685e6b49279"
      ],
      "price_cents": 1500,
      "price_range": {
        "min_cents": 5000,
        "max_cents": 5000
      },
      "delay_seconds": 300,
      "delete_if_no_reply_after_seconds": 300,
      "delete_on_next_message": true
    }
  ],
  "filters": {
    "include": {
      "statuses": [
        "active_subscriber"
      ],
      "tag_ids": [
        "58368a92-838b-4cb0-ab37-d54ce826ea11"
      ],
      "min_spend_cents": 5000,
      "min_tips_cents": 5000,
      "min_subscription_months": 12,
      "is_online": true,
      "min_paid_spend_7d_cents": 5000,
      "min_paid_spend_30d_cents": 5000,
      "min_paid_spend_90d_cents": 5000,
      "min_payments_7d": 1,
      "min_payments_30d": 1,
      "min_payments_90d": 1,
      "spender_tiers": [
        "none"
      ],
      "media_purchase": {
        "mode": "within",
        "hours": 12
      }
    },
    "exclude": {
      "tag_ids": [
        "58368a92-838b-4cb0-ab37-d54ce826ea11"
      ],
      "messaged_within_hours": 12,
      "fan_messaged_within_hours": 12,
      "has_unread_from_fan": true,
      "already_unlocked_media": true,
      "already_received_media": true
    }
  },
  "initial_delay_seconds": 300,
  "min_send_interval_hours": 12,
  "stop_sequence_on_reply": true
}

Parameters

Headers

Fansquare-Versionstringrequired
API version to pin. Accepts the mineral name or the release date of a version.

Path

automation_idstringrequired
Fansquare automation id (the id field of automation items).
format uuid

Response

OK, application/json

idstringrequired
Fansquare automation id. Path parameter of the /v1/automations/{automation_id} routes.
creator_idstringrequired
Fansquare creator id (see GET /v1/creators).
namestringrequired
Name shown in Fansquare.
statusstringrequired
active (fires on its trigger), paused, draft (created in the app, never activated) or cancelled.
Valuesactivepauseddraftcancelled
triggerobjectrequired
The event that fires it, in the shape of the create body.
typestringrequired
The event.
Valuesnew_subscribernew_interestedresubscriptionnear_expirationsubscription_endedmedia_purchasenew_tipmod_purchasefan_onlinebirthday
days_beforeinteger
near_expiration (required, 1 to 365) and birthday (0 = on the day, the default): how many days before.
min 0max 365
send_time_localstring
near_expiration and birthday (required): wall-clock time of the send, HH:mm, in timezone.
pattern ^([01]\d|2[0-3]):[0-5]\d$
timezonestring
IANA time zone of send_time_local and of the online window, e.g. Europe/Paris.
min length 1max length 100
min_amount_centsinteger
media_purchase, new_tip, mod_purchase: fire only from this amount, in euro cents.
min 0max 100000000
online_window_startstring
fan_online: start of the window, HH:mm in timezone (with online_window_end).
pattern ^([01]\d|2[0-3]):[0-5]\d$
online_window_endstring
fan_online: end of the window, HH:mm in timezone (with online_window_start).
pattern ^([01]\d|2[0-3]):[0-5]\d$
statsobjectrequired
Lifetime totals.
triggered_countintegerrequired
Times it fired.
fans_contactedintegerrequired
Fans its messages reached.
failed_countintegerrequired
Messages that could not be delivered.
revenue_centsintegerrequired
Gross revenue of the media it sent, bought within 30 days of each send, in euro cents.
purchasesintegerrequired
Number of those purchases.
repliesintegerrequired
Fans who replied after a message.
readsintegerrequired
Fans who opened a message.
last_triggered_atstring | nullrequired
Last time it fired, or null.
format date-time
created_atstringrequired
When it was created (ISO 8601).
format date-time
activated_atstring | nullrequired
Last activation: events older than this never fire it.
format date-time
messagesarray of objectsrequired
The sequence sent each time it fires.
textstringrequired
Text of the message.
media_idsarray of stringsrequired
MYM media uuids from the creator's vault.
price_centsinteger | nullrequired
Fixed price to unlock the media, in euro cents. null: free, or dynamic (see price_range).
price_rangeobject | nullrequired
Dynamic SpenderIQ price range in euro cents, or null for a fixed price.
min_centsintegerrequired
max_centsintegerrequired
delay_secondsintegerrequired
Wait after the previous message, in seconds (0 on the first message).
delete_if_no_reply_after_secondsinteger | nullrequired
Deleted if the fan has not replied after this many seconds, or null.
delete_on_next_messagebooleanrequired
Deleted when the next message of the sequence is sent.
filtersobjectrequired
Audience filters, in the shape of the create body: only the conditions that are set.
includeobject
Conditions a fan must ALL meet to be targeted.
statusesarray of strings
Subscription status of the fan on this account, same vocabulary as the statuses filter of GET /v1/accounts/{account_id}/fans: active_subscriber, former_subscriber, interested (follows the creator without subscribing). Any of them. Absent or empty: no status condition, every fan with a conversation is in, whatever their status.
Valuesactive_subscriberformer_subscriberinterestedmax items 3
tag_idsarray of strings
Only fans carrying at least one of these tags (ids from GET /v1/tags).
format uuidmax items 100
min_spend_centsinteger
Total à-la-carte spend of the fan on this account at least this amount, in euro cents, gross (before the MYM commission). Same figure as spend.total_cents of a fan in GET /v1/accounts/{account_id}/fans.
min 0max 100000000
min_tips_centsinteger
Sum of the tips the fan sent this account at least this amount, in euro cents.
min 0max 100000000
min_subscription_monthsinteger
Fans whose first subscription to this account started at least this many months ago.
min 0max 1200
is_onlineboolean
true: only fans online on MYM when the audience is resolved (at send time for a Mass DM, at the trigger for an automation). false or absent: no condition.
min_paid_spend_7d_centsinteger
Paid spend (subscriptions and purchases) of the fan on this account over the last 7 days at least this amount, in euro cents.
min 0max 100000000
min_paid_spend_30d_centsinteger
Same over the last 30 days.
min 0max 100000000
min_paid_spend_90d_centsinteger
Same over the last 90 days.
min 0max 100000000
min_payments_7dinteger
Number of paid orders of the fan on this account over the last 7 days at least this value.
min 0max 100000
min_payments_30dinteger
Same over the last 30 days.
min 0max 100000
min_payments_90dinteger
Same over the last 90 days.
min 0max 100000
spender_tiersarray of strings
SpenderIQ tiers, any of them, from the paid spend of the fan on this account over the last 90 days: none (nothing), low (under 50 EUR), medium (50 EUR or more), high (300 EUR or more), whale (1,500 EUR or more).
Valuesnonelowmediumhighwhalemax items 5
media_purchaseobject
Last private media purchase of the fan on this account.
modestringrequired
within: the fan bought a private media in the last hours. not_since: no private media purchase for hours (fans who never bought are in).
Valueswithinnot_since
hoursintegerrequired
Window in hours (1 to 8760).
min 1max 8760
excludeobject
Conditions that leave a fan out.
tag_idsarray of strings
Leave out fans carrying any of these tags. A tag cannot be both included and excluded.
format uuidmax items 100
messaged_within_hoursinteger
Leave out fans the account sent a message to in the last N hours (a chatter, a script or another Mass DM sent from Fansquare).
min 1max 8760
fan_messaged_within_hoursinteger
Leave out fans who wrote to the account in the last N hours: never push into a live conversation. Checked again on MYM at send time.
min 1max 8760
has_unread_from_fanboolean
true: leave out fans whose last message to the account is still unread.
already_unlocked_mediaboolean
true: leave out fans who already have a media of this campaign unlocked (sent free, or bought).
already_received_mediaboolean
true: leave out fans who already received a media of this campaign, bought or not.
initial_delay_secondsintegerrequired
Wait between the event and the first message, in seconds.
min_send_interval_hoursintegerrequired
Minimum hours between two firings for the same fan.
stop_sequence_on_replybooleanrequired
A fan who replies does not receive the next messages of the sequence.

curl -X POST 'https://api.fansquare.so/v1/automations/8f17cc65-760b-4c46-a945-b9395948cb15/resume' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Fansquare-Version: Amethyste"

{
  "id": "8f17cc65-760b-4c46-a945-b9395948cb15",
  "creator_id": "m81IhLxdhzDGYs54rNp2",
  "name": "Lena",
  "status": "active",
  "trigger": {
    "type": "new_subscriber",
    "days_before": 1,
    "send_time_local": "string",
    "timezone": "Europe/Paris",
    "min_amount_cents": 4900,
    "online_window_start": "string",
    "online_window_end": "string"
  },
  "stats": {
    "triggered_count": 12,
    "fans_contacted": 1,
    "failed_count": 2,
    "revenue_cents": 4900,
    "purchases": 12,
    "replies": 12,
    "reads": 12,
    "last_triggered_at": "2026-10-12T21:14:00.000Z"
  },
  "created_at": "2026-10-12T21:14:00.000Z",
  "activated_at": "2026-10-12T21:14:00.000Z",
  "messages": [
    {
      "text": "string",
      "media_ids": [
        "b12eacb2-afea-4959-a0d0-b685e6b49279"
      ],
      "price_cents": 1500,
      "price_range": {
        "min_cents": 5000,
        "max_cents": 5000
      },
      "delay_seconds": 300,
      "delete_if_no_reply_after_seconds": 300,
      "delete_on_next_message": true
    }
  ],
  "filters": {
    "include": {
      "statuses": [
        "active_subscriber"
      ],
      "tag_ids": [
        "58368a92-838b-4cb0-ab37-d54ce826ea11"
      ],
      "min_spend_cents": 5000,
      "min_tips_cents": 5000,
      "min_subscription_months": 12,
      "is_online": true,
      "min_paid_spend_7d_cents": 5000,
      "min_paid_spend_30d_cents": 5000,
      "min_paid_spend_90d_cents": 5000,
      "min_payments_7d": 1,
      "min_payments_30d": 1,
      "min_payments_90d": 1,
      "spender_tiers": [
        "none"
      ],
      "media_purchase": {
        "mode": "within",
        "hours": 12
      }
    },
    "exclude": {
      "tag_ids": [
        "58368a92-838b-4cb0-ab37-d54ce826ea11"
      ],
      "messaged_within_hours": 12,
      "fan_messaged_within_hours": 12,
      "has_unread_from_fan": true,
      "already_unlocked_media": true,
      "already_received_media": true
    }
  },
  "initial_delay_seconds": 300,
  "min_send_interval_hours": 12,
  "stop_sequence_on_reply": true
}