> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onlyfansapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Scheduled Mass Messages (/api-reference/fansly/mass-messaging/list-scheduled-mass-messages)

List the account's pending scheduled broadcasts. The response also includes the `groups` referenced by the scheduled messages — each `groupId` is a broadcast group that defines the recipient set (subscribers, lists, excluded users).

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-fansly-docs/openapi.yaml get /api/fansly/{fanslyAccount}/mass-messaging
openapi: 3.0.3
info:
  title: Fansly API Documentation
  description: ""
  version: 1.0.0
servers:
  - url: https://app.onlyfansapi.com
security:
  - default: []
tags:
  - name: Account
    description: Endpoints for your linked Fansly accounts
  - name: Chat Messages
    description: Endpoints for Fansly chats (messaging groups)
  - name: Chats
    description: Endpoints for Fansly chats (messaging groups)
  - name: Connect Fansly Account
    description: ""
  - name: Earnings
    description: Endpoints for Fansly Earnings — wallets, balances, transactions,
      payouts, and statements.
  - name: Followers
    description: Endpoints for Fansly followers.
  - name: Following
    description: Endpoints for the accounts a Fansly Account is following.
  - name: Lists
    description: Endpoints for Fansly subscriber/fan lists (e.g. "VIP", "Spenders").
  - name: Mass Messaging
    description: Endpoints for Fansly mass messages (broadcasts) — send one message
      to many recipients at once, and manage scheduled broadcasts.
  - name: Media
    description: Upload media for use in Fansly posts and messages
  - name: Posts
    description: Endpoints for Fansly wall posts.
  - name: Profile Statistics
    description: Endpoints for Fansly Profile Statistics (viewer engagement insights).
  - name: Subscribers
    description: Endpoints for Fansly subscribers and subscription tiers.
  - name: Subscription Discounts
    description: Endpoints for Fansly subscription discounts (shown as "Gift Links"
      in the Fansly Dashboard).
  - name: Top Supporters
    description: Endpoints for the Fansly "Top Supporters" view — see who spends the
      most and what they spend on.
  - name: Tracking Links
    description: Endpoints for Fansly tracking links — per-source attribution links
      (e.g. "Twitter bio", "FYP", "Search").
  - name: Users
    description: APIs for fetching Fansly users
  - name: Walls
    description: Endpoints for Fansly walls — the tabbed feeds on a creator profile
      that posts are published to.
paths:
  /api/fansly/{fanslyAccount}/mass-messaging:
    parameters:
      - in: path
        name: fanslyAccount
        description: The Fansly Account ID
        example: fansly_acct_XXXXXXXXXXXXXXX
        required: true
        schema:
          type: string
    get:
      summary: List Scheduled Mass Messages
      operationId: listScheduledMassMessages
      description: List the account's pending scheduled broadcasts. The response also
        includes the `groups` referenced by the scheduled messages — each
        `groupId` is a broadcast group that defines the recipient set
        (subscribers, lists, excluded users).
      parameters: []
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    scheduledBroadcastMessages:
                      - id: "300000000000000020"
                        groupId: "200000000000000020"
                        accountId: "800000000000000001"
                        status: 1
                        messageTemplate: '{"type":1,"attachments":[],"content":"Hey everyone, new
                          content is
                          live!","groupId":"200000000000000020","senderId":"800000000000000001","scheduledFor":1785110911809,"clientCreatedAt":1784502540759,"gatewayMetadata":{"createdAt":1784502540831,"correlationId":"300000000000000021"}}'
                        version: 0
                        scheduledFor: 1785110912000
                    groups:
                      - id: "200000000000000020"
                        type: 3
                        groupFlags: 126
                        groupFlagsMetadata: ""
                        createdBy: "800000000000000001"
                        users:
                          - groupId: "200000000000000020"
                            userId: "900000000000000001"
                            type: 0
                            permissionFlags: 0
                            userSettings:
                              customName: ""
                              hidden: 1
                          - groupId: "200000000000000020"
                            userId: "800000000000000001"
                            type: 0
                            permissionFlags: 65535
                            userSettings:
                              customName: ""
                              hidden: 0
                        permissionFlags: []
                        recipients:
                          - groupId: "200000000000000020"
                            recipientId: "900000000000000002"
                            type: 30000
                            permissionFlags: null
                          - groupId: "200000000000000020"
                            recipientId: "900000000000000003"
                            type: 30001
                            permissionFlags: null
                  _meta:
                    _credits:
                      used: 1
                      balance: 10055789
                      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.
                properties:
                  data:
                    type: object
                    properties:
                      scheduledBroadcastMessages:
                        type: array
                        example:
                          - id: "300000000000000020"
                            groupId: "200000000000000020"
                            accountId: "800000000000000001"
                            status: 1
                            messageTemplate: '{"type":1,"attachments":[],"content":"Hey everyone, new
                              content is
                              live!","groupId":"200000000000000020","senderId":"800000000000000001","scheduledFor":1785110911809,"clientCreatedAt":1784502540759,"gatewayMetadata":{"createdAt":1784502540831,"correlationId":"300000000000000021"}}'
                            version: 0
                            scheduledFor: 1785110912000
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              example: "300000000000000020"
                            groupId:
                              type: string
                              example: "200000000000000020"
                            accountId:
                              type: string
                              example: "800000000000000001"
                            status:
                              type: integer
                              example: 1
                            messageTemplate:
                              type: string
                              example: '{"type":1,"attachments":[],"content":"Hey everyone, new content is
                                live!","groupId":"200000000000000020","senderId":"800000000000000001","scheduledFor":1785110911809,"clientCreatedAt":1784502540759,"gatewayMetadata":{"createdAt":1784502540831,"correlationId":"300000000000000021"}}'
                            version:
                              type: integer
                              example: 0
                            scheduledFor:
                              type: integer
                              example: 1785110912000
                      groups:
                        type: array
                        example:
                          - id: "200000000000000020"
                            type: 3
                            groupFlags: 126
                            groupFlagsMetadata: ""
                            createdBy: "800000000000000001"
                            users:
                              - groupId: "200000000000000020"
                                userId: "900000000000000001"
                                type: 0
                                permissionFlags: 0
                                userSettings:
                                  customName: ""
                                  hidden: 1
                              - groupId: "200000000000000020"
                                userId: "800000000000000001"
                                type: 0
                                permissionFlags: 65535
                                userSettings:
                                  customName: ""
                                  hidden: 0
                            permissionFlags: []
                            recipients:
                              - groupId: "200000000000000020"
                                recipientId: "900000000000000002"
                                type: 30000
                                permissionFlags: null
                              - groupId: "200000000000000020"
                                recipientId: "900000000000000003"
                                type: 30001
                                permissionFlags: null
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              example: "200000000000000020"
                            type:
                              type: integer
                              example: 3
                            groupFlags:
                              type: integer
                              example: 126
                            groupFlagsMetadata:
                              type: string
                              example: ""
                            createdBy:
                              type: string
                              example: "800000000000000001"
                            users:
                              type: array
                              example:
                                - groupId: "200000000000000020"
                                  userId: "900000000000000001"
                                  type: 0
                                  permissionFlags: 0
                                  userSettings:
                                    customName: ""
                                    hidden: 1
                                - groupId: "200000000000000020"
                                  userId: "800000000000000001"
                                  type: 0
                                  permissionFlags: 65535
                                  userSettings:
                                    customName: ""
                                    hidden: 0
                              items:
                                type: object
                                properties:
                                  groupId:
                                    type: string
                                    example: "200000000000000020"
                                  userId:
                                    type: string
                                    example: "900000000000000001"
                                  type:
                                    type: integer
                                    example: 0
                                  permissionFlags:
                                    type: integer
                                    example: 0
                                  userSettings:
                                    type: object
                                    properties:
                                      customName:
                                        type: string
                                        example: ""
                                      hidden:
                                        type: integer
                                        example: 1
                            permissionFlags:
                              type: array
                              example: []
                            recipients:
                              type: array
                              example:
                                - groupId: "200000000000000020"
                                  recipientId: "900000000000000002"
                                  type: 30000
                                  permissionFlags: null
                                - groupId: "200000000000000020"
                                  recipientId: "900000000000000003"
                                  type: 30001
                                  permissionFlags: null
                              items:
                                type: object
                                properties:
                                  groupId:
                                    type: string
                                    example: "200000000000000020"
                                  recipientId:
                                    type: string
                                    example: "900000000000000002"
                                  type:
                                    type: integer
                                    example: 30000
                                  permissionFlags:
                                    type: string
                                    example: null
                                    nullable: true
                  _meta:
                    type: object
                    properties:
                      _credits:
                        type: object
                        properties:
                          used:
                            type: integer
                            example: 1
                          balance:
                            type: integer
                            example: 10055789
                          note:
                            type: string
                            example: Always
                      _cache:
                        type: object
                        properties:
                          is_cached:
                            type: boolean
                            example: false
                          note:
                            type: string
                            example: Cache disabled for this endpoint
                      _rate_limits:
                        type: object
                        properties:
                          limit_minute:
                            type: integer
                            example: 5000
                          limit_day:
                            type: string
                            example: null
                            nullable: true
                          remaining_minute:
                            type: integer
                            example: 4999
                          remaining_day:
                            type: string
                            example: null
                            nullable: true
                          notice:
                            type: string
                            example: We have decided to remove our daily rate limits. Please remove any
                              references to these in your integrations.
      tags:
        - Mass Messaging
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: Get your API Key from OnlyFansAPI Console -
        https://app.onlyfansapi.com/api-keys
````