openapi: 3.1.0
info:
  title: Formstack Confirmations API
  description: 'REST API for Formstack — manage forms, fields, submissions, confirmations,

    notifications, webhooks, themes, folders, portals, smart lists, subaccounts,

    submit actions, and partial submissions. Authentication uses OAuth 2.0.


    Detailed endpoint definitions are derived from the public developer portal

    at https://developers.formstack.com/ (machine-readable index at

    https://developers.formstack.com/llms.txt).

    '
  version: 2025.0
  contact:
    name: Formstack Developers
    url: https://developers.formstack.com/
servers:
- url: https://www.formstack.com/api/v2
  description: Production v2
security:
- oauth2: []
tags:
- name: Confirmations
paths:
  /form/{formId}/confirmation.json:
    parameters:
    - $ref: '#/components/parameters/formId'
    get:
      summary: List confirmations
      operationId: listConfirmations
      tags:
      - Confirmations
      responses:
        '200':
          description: Confirmations.
    post:
      summary: Create confirmation
      operationId: createConfirmation
      tags:
      - Confirmations
      responses:
        '200':
          description: Created.
  /confirmation/{confirmationId}.json:
    parameters:
    - $ref: '#/components/parameters/confirmationId'
    get:
      summary: Get confirmation
      operationId: getConfirmation
      tags:
      - Confirmations
      responses:
        '200':
          description: Confirmation.
    put:
      summary: Update confirmation
      operationId: updateConfirmation
      tags:
      - Confirmations
      responses:
        '200':
          description: Updated.
    delete:
      summary: Delete confirmation
      operationId: deleteConfirmation
      tags:
      - Confirmations
      responses:
        '200':
          description: Deleted.
components:
  parameters:
    formId:
      name: formId
      in: path
      required: true
      schema:
        type: string
    confirmationId:
      name: confirmationId
      in: path
      required: true
      schema:
        type: string
  securitySchemes:
    oauth2:
      type: oauth2
      description: OAuth 2.0 authorization code flow.
      flows:
        authorizationCode:
          authorizationUrl: https://www.formstack.com/api/v2/oauth2/authorize
          tokenUrl: https://www.formstack.com/api/v2/oauth2/token
          scopes:
            forms_read: Read forms
            forms_write: Manage forms
            submissions_read: Read submissions
            submissions_write: Manage submissions