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

# Set an integration's schedule (a SQL warehouse or Pendo)

> Sets the schedule of each subtype you send, as the app's Schedule tab does; subtypes you leave out keep theirs. enabled false stops a subtype's scheduled runs. Weekly takes day, hour, minute and timezone together. product_usage takes daily, weekly or monthly only: a usage widget cannot show a sub-day period. Pendo has no default cadence: a subtype with no schedule entry never runs, so set one for each subtype you use. The subtype follows the query: an account custom_field query runs as account_custom_fields, a people custom_field query as people_custom_fields, product_usage as product_usage, custom_object as custom_objects. The NPS survey job is the subtype surveys.



## OpenAPI

````yaml /api/statisfy-api.openapi.json put /v1/integrations/{key}/schedule
openapi: 3.1.0
info:
  description: >-
    The agent-first Statisfy API. Authenticate with an API key (`Authorization:
    Bearer stfy_live_…`), then call `GET /v1/meta/capabilities` to discover
    every operation and its schemas.
  title: Statisfy API
  version: 1.0.0
servers:
  - url: https://api.statisfy.com
    description: Production
security: []
paths:
  /v1/integrations/{key}/schedule:
    put:
      tags:
        - integrations
      summary: Set an integration's schedule (a SQL warehouse or Pendo)
      description: >-
        Sets the schedule of each subtype you send, as the app's Schedule tab
        does; subtypes you leave out keep theirs. enabled false stops a
        subtype's scheduled runs. Weekly takes day, hour, minute and timezone
        together. product_usage takes daily, weekly or monthly only: a usage
        widget cannot show a sub-day period. Pendo has no default cadence: a
        subtype with no schedule entry never runs, so set one for each subtype
        you use. The subtype follows the query: an account custom_field query
        runs as account_custom_fields, a people custom_field query as
        people_custom_fields, product_usage as product_usage, custom_object as
        custom_objects. The NPS survey job is the subtype surveys.
      operationId: integrations_put_schedule
      parameters:
        - description: The integration key, such as snowflake or salesforce
          in: path
          name: key
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: false
              properties:
                schedules:
                  items:
                    $ref: '#/components/schemas/ScheduleEntry'
                  title: Schedules
                  type: array
              required:
                - schedules
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntegrationSchedule'
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    ScheduleEntry:
      properties:
        cadence:
          title: Cadence
          type: string
        day:
          anyOf:
            - maximum: 6
              minimum: 0
              type: integer
            - type: 'null'
          default: null
          title: Day
        enabled:
          default: true
          title: Enabled
          type: boolean
        hour:
          anyOf:
            - maximum: 23
              minimum: 0
              type: integer
            - type: 'null'
          default: null
          title: Hour
        minute:
          anyOf:
            - maximum: 59
              minimum: 0
              type: integer
            - type: 'null'
          default: null
          title: Minute
        subtype:
          title: Subtype
          type: string
        timezone:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Timezone
        week_start_day:
          anyOf:
            - maximum: 6
              minimum: 0
              type: integer
            - type: 'null'
          default: null
          title: Week Start Day
      required:
        - subtype
        - cadence
      title: ScheduleEntry
      type: object
    IntegrationSchedule:
      properties:
        schedules:
          description: >-
            One entry per subtype: its cadence, and for weekly an optional day,
            hour, minute and timezone. enabled false means the subtype does not
            run on a schedule
          items:
            $ref: '#/components/schemas/IntegrationSubtypeSchedule'
          title: Schedules
          type: array
      required:
        - schedules
      title: IntegrationSchedule
      type: object
    IntegrationSubtypeSchedule:
      properties:
        cadence:
          description: >-
            hourly, two_hours, four_hours, six_hours, twelve_hours, daily,
            weekly or monthly. product_usage takes daily, weekly or monthly only
          title: Cadence
          type: string
        day:
          anyOf:
            - type: integer
            - type: 'null'
          description: 'weekly: the day it runs, 0 = Monday … 6 = Sunday'
          title: Day
        enabled:
          title: Enabled
          type: boolean
        hour:
          anyOf:
            - type: integer
            - type: 'null'
          title: Hour
        minute:
          anyOf:
            - type: integer
            - type: 'null'
          title: Minute
        subtype:
          title: Subtype
          type: string
        timezone:
          anyOf:
            - type: string
            - type: 'null'
          description: 'weekly: the IANA timezone day, hour and minute are in'
          title: Timezone
        week_start_day:
          anyOf:
            - type: integer
            - type: 'null'
          title: Week Start Day
      required:
        - subtype
        - cadence
        - week_start_day
        - day
        - hour
        - minute
        - timezone
        - enabled
      title: IntegrationSubtypeSchedule
      type: object
  securitySchemes:
    HTTPBearer:
      scheme: bearer
      type: http
      description: >-
        An API key, sent as `Authorization: Bearer stfy_live_…`. See
        [Authentication](/rest-api/authentication) for how to get one and which
        scopes it needs.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.