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

# Schedule audience push

> Schedule a push notification for a push-eligible audience using an active push template. The existing notification cron sends it when scheduled_date is due.



## OpenAPI

````yaml POST /push/audiences/{id}/schedule
openapi: 3.0.1
info:
  title: Masivo's REST API
  description: Learn how to use Masivo's REST API
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://app.masivo.ai/api/storefront/v1
security:
  - bearerAuth: []
paths:
  /push/audiences/{id}/schedule:
    post:
      summary: Schedule a push for an audience
      description: >-
        Schedule a push notification for a push-eligible audience using an
        active push template. The existing notification cron sends it when
        scheduled_date is due.
      operationId: scheduleAudiencePush
      parameters:
        - in: header
          name: x-account-id
          description: The account id that owns the audience and push template.
          required: true
          schema:
            type: string
            format: uuid
        - in: path
          name: id
          description: The audience id
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PushAudienceScheduleRequest'
            example:
              push_template_id: 00000000-0000-4000-8000-000000000003
              scheduled_date: '2026-07-03T15:00:00.000Z'
              label: Promo julio
      responses:
        '201':
          description: Push delivery history scheduled
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/PushAudienceScheduleResult'
              example:
                data:
                  id: 00000000-0000-4000-8000-000000000004
                  account_id: 00000000-0000-4000-8000-000000000001
                  scheduled_date: '2026-07-03T15:00:00.000Z'
                  type: PUSH
                  status: SCHEDULED
                  label: Promo julio
                  template_id: 00000000-0000-4000-8000-000000000003
                  audience_id: 00000000-0000-4000-8000-000000000002
                  audience_bucket_id: 9
                  short_urls: []
        '404':
          description: Audience or push template not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Audience cannot receive push or request is invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    PushAudienceScheduleRequest:
      type: object
      required:
        - push_template_id
      properties:
        push_template_id:
          description: The active push template id to schedule
          type: string
          format: uuid
        scheduled_date:
          description: When to send the push. Defaults to now when omitted.
          type: string
          format: date-time
        label:
          description: Optional delivery history label
          type: string
          maxLength: 100
    PushAudienceScheduleResult:
      type: object
      properties:
        id:
          type: string
          format: uuid
        account_id:
          type: string
          format: uuid
        scheduled_date:
          type: string
          format: date-time
        type:
          type: string
          enum:
            - PUSH
        status:
          type: string
          enum:
            - SCHEDULED
        label:
          type: string
          nullable: true
        template_id:
          type: string
          format: uuid
        audience_id:
          type: string
          format: uuid
        audience_bucket_id:
          type: number
        short_urls:
          type: array
          items:
            type: string
    Error:
      required:
        - error
        - details
      type: object
      properties:
        error:
          type: string
        details:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````