Blog/Tutorials
Tutorials

Mass Messaging at Scale: Using the Messaging API for OnlyFans Campaigns

Build PPV campaigns with the OnlyFans messaging API.

T
The Only API Team·Mar 4, 2026·5 min read
Mass Messaging at Scale: Using the Messaging API for OnlyFans Campaigns

Mass messaging is the most direct revenue lever on OnlyFans. A single well-crafted PPV message sent to 1,000 subscribers at an 8% conversion rate and a $15 price point generates $1,200 in revenue — from one message. The messaging API resolves an audience, previews it, and delivers to it, making it possible to run sophisticated campaigns across dozens of accounts simultaneously.

This guide covers everything from basic campaign setup to advanced A/B testing strategies.

Why Mass Messaging Drives Revenue

The data is clear on why mass messaging matters:

PPV attach rates. Creators who send regular PPV mass messages earn 50-70% more than those who rely on subscriptions alone. PPV is not a supplement to subscription revenue — it is the primary revenue driver for most top earners.

Tip volume. Mass messages that include engaging content (behind-the-scenes, personal updates, teaser content) increase overall tip volume by creating touchpoints that remind fans to engage.

Subscriber retention. Regular messaging keeps subscribers engaged. Creators who message their fans 3-5 times per week have 30-40% lower churn rates than those who post content but never send messages.

Direct conversion tracking. Unlike content posts, mass messages have clear metrics: delivery count, open rate, purchase rate, and revenue generated. This makes them the most measurable marketing activity on the platform.

API Endpoints for Messaging

The Only API provides comprehensive messaging endpoints:

Send Message: POST /api/crm/{crm_id}/accounts/{of_user_id}/chats/{with_user_id}/messages — a single DM or PPV to one fan. Supports text, media, and a price for pay-per-view.

Mass Message: POST /api/crm/{crm_id}/accounts/{of_user_id}/messages/mass — audience-resolved bulk send, no looping required. The audience object accepts a type of active, all, or expired, an explicit fan_ids override, a min_spent floor, and a since/until subscription window.

Dry-run preview: the mass endpoint's dry_run flag defaults to true. On a dry run it resolves and counts the recipients and returns a sample without sending anything — the "who will this reach?" check. Set dry_run to false to actually deliver.

PPV Stats: GET /api/crm/{crm_id}/accounts/{of_user_id}/ppv-stats — purchase and revenue metrics for pay-per-view sends.

Fans and Tags: GET /api/crm/{crm_id}/fans to read the roster, POST /api/crm/{crm_id}/fans/{fan_id}/tags to segment it. This is how you build the targeted audiences you would otherwise keep in a list.

Scheduling: there is no message queue endpoint. Scheduled and triggered sends are configured through the automations API (POST /api/crm/{crm_id}/automations), not a queue.

Platform note: mass messaging is OnlyFans-only. Calling the mass endpoint against a Fansly-connected account returns HTTP 501 with the code PLATFORM_NOT_SUPPORTED. One-to-one DMs work on both platforms.

Building a Campaign: Segmentation, Content, Schedule, Measure

Step 1: Segment Your Audience

Not every subscriber should receive every message. Segment by:

  • Spending history: High-spenders get premium PPV at higher prices. New subscribers get introductory offers.
  • Engagement level: Active fans get exclusive content. Inactive fans get re-engagement offers.
  • Purchase history: Fans who bought the last PPV get offered the next one. Fans who did not get a different approach.

Step 2: Create the Content

The most successful PPV messages have these elements:

  • Compelling preview text: 1-2 sentences that create curiosity without revealing everything
  • High-quality content: The actual PPV content should feel premium and exclusive
  • Strategic pricing: Test different price points. Many agencies find $10-$20 is the sweet spot for regular PPV, with $30-$50 for premium content.

Step 3: Schedule Delivery

Timing matters. Best practices:

  • Weekdays: Tuesday through Thursday typically show the highest conversion rates
  • Evening hours: 7 PM to 11 PM in the subscriber's primary timezone
  • Avoid Monday mornings and Friday nights: Lower open rates
  • Stagger delivery: Do not blast all subscribers at once. Spread delivery over 1-2 hours for better deliverability.

Step 4: Measure Results

Within 48 hours of sending, pull these metrics via the API:

  • Delivery rate: What percentage of subscribers received the message?
  • Open rate: What percentage opened it?
  • Conversion rate: What percentage purchased?
  • Revenue generated: Total and per-subscriber
  • Revenue per open: This is your true efficiency metric

Log these results in your analytics system and compare across campaigns.

A/B Testing Message Variations

A/B testing is how you find out what works for each creator's audience:

What to test:

  • Price points: $9.99 vs $14.99 vs $19.99 for the same content
  • Preview text: Different hooks and teaser angles
  • Content type: Photo sets vs videos vs mixed media
  • Send time: Morning vs evening, weekday vs weekend
  • Message tone: Direct and explicit vs mysterious and teasing

How to test:

  1. 1.Split your subscriber list into two equal random groups
  2. 2.Send variant A to Group 1 and variant B to Group 2
  3. 3.Wait 48 hours for results to stabilize
  4. 4.Compare conversion rates and total revenue
  5. 5.Use the winner for your next full campaign

Over time, A/B testing builds a playbook specific to each creator that consistently outperforms untested campaigns.

Compliance and Best Practices

Mass messaging comes with responsibilities:

  • Frequency limits: Do not spam. 3-5 mass messages per week is the sweet spot. More than that and you risk unsubscribes.
  • Content variety: Alternate between PPV offers, free content, and personal messages. A feed that is 100% PPV feels transactional.
  • Unsubscribe respect: If fans request fewer messages, honor it. Build a "low-frequency" segment.
  • Platform compliance: Follow OnlyFans messaging policies. Avoid prohibited content and misleading claims.

How The Only API Helps

The Only API makes mass messaging at scale effortless:

  • Single-DM and mass-message endpoints for one-to-one sends and audience-resolved bulk sends in a single call
  • Audience resolution with a dry-run preview — dry_run defaults to true and returns a recipient count and sample before anything is delivered
  • PPV stats (GET /api/crm/{crm_id}/accounts/{of_user_id}/ppv-stats) to measure campaign performance
  • Fan tagging and notes (GET /api/crm/{crm_id}/fans, POST /api/crm/{crm_id}/fans/{fan_id}/tags) for precise audience segmentation
  • Trigger-based sends through the automations API for welcome flows and win-backs
  • Unlimited API calls on paid slots — no credits and no per-call fees. The free plan includes 1,000 calls/month.

No credits and no per-call charges. Mass messaging is OnlyFans-only today; Fansly-connected accounts support one-to-one DMs.

Launch your first campaign. Start Building Free

Best practices for mass DMs that don't get you banned

Mass messaging is powerful, but blasting every fan the same message is the fastest way to tank conversion and trip platform limits. What actually works:

  • Segment before you send. Message recent spenders, lapsed subscribers, and never-purchased fans differently. Relevance drives both conversion and deliverability.
  • Throttle and randomize. Spreading sends over time, rather than firing thousands at once, mirrors human behavior and stays within safe limits.
  • Personalize with merge fields. A fan's name and last-purchase context lifts reply rates well above a generic blast.
  • Lead with value, then the offer. A short, warm opener before the pay-per-view link converts better than a cold drop.

Frequently asked questions

Can I send mass DMs to all subscribers via the API?

Yes, on OnlyFans accounts. POST /api/crm/{crm_id}/accounts/{of_user_id}/messages/mass reaches your entire subscriber base or any segment of it, including pay-per-view content with a price attached. Because dry_run defaults to true, your first call returns a recipient count and sample rather than sending — set dry_run to false to deliver. Mass messaging is not yet available for Fansly accounts (the endpoint returns 501 PLATFORM_NOT_SUPPORTED). See the OnlyFans Auto DM guide for the full workflow.

Will mass messaging get my account banned?

Not if you segment, throttle, and personalize. The risk comes from large identical blasts sent instantly; the API is built to send at a safe, human-like cadence.

Does each message cost extra?

No per-message or per-call fees and no credit system. Mass messaging is currently OnlyFans-only; free-plan panels are capped at 1,000 API calls/month, while paid slots are uncapped at the monthly level (a 600 requests/minute anti-flood cap applies to every plan).

Can I schedule campaigns in advance?

Yes — through the automations API rather than a message queue. Create a rule with POST /api/crm/{crm_id}/automations, test it with POST /api/crm/{crm_id}/automations/{id}/run-now, and review each execution at GET /api/crm/{crm_id}/automations/{id}/runs. Welcome flows, win-backs, and tip-day campaigns all work this way. See the automation API.