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

# List the saved versions of your account's wording for one email

> Every saved version of this email's wording at this level, newest first: what it held after each save, including whether it was switched off, and who saved it. Page with `pageSize` (1 to 50, default 20) and the `paginationToken` the previous page returned (also in `metadata.paginationToken`).



## OpenAPI

````yaml /api-reference/specs/notification.json get /customer/email-settings/{eventType}/revisions
openapi: 3.0.1
info:
  title: Email wording API
  description: >-
    The wording of the emails we send for you: payslips, P45s, P60s, pension
    enrolment letters, report-ready and webhook alerts, and, for your whole
    account, the sign-in emails. Set it once for your account, or for one
    organisation; each field falls back on its own to the account's, then the
    standard wording. Report-ready and webhook alerts can be switched off.
    Preview the real email, and go back to any saved version. Your brand,
    statutory content and links always stay.
  version: v1
servers:
  - url: https://api.sandbox.flowpayroll.ai/v1/notification-settings
security:
  - X-Auth-Token: []
paths:
  /customer/email-settings/{eventType}/revisions:
    get:
      tags:
        - Account emails
      summary: List the saved versions of your account's wording for one email
      description: >-
        Every saved version of this email's wording at this level, newest first:
        what it held after each save, including whether it was switched off, and
        who saved it. Page with `pageSize` (1 to 50, default 20) and the
        `paginationToken` the previous page returned (also in
        `metadata.paginationToken`).
      operationId: ListAccountEmailWordingRevisions
      parameters:
        - name: eventType
          in: path
          required: true
          schema:
            type: string
            enum:
              - PayslipGeneratedEvent
              - P45GeneratedEvent
              - P60GeneratedEvent
              - EmployeePensionEnrolmentEvent
              - ReportReadyEvent
              - WebhookEndpointFailingEvent
              - WebhookEndpointDisabledEvent
              - UserInvitedEvent
              - EmailVerificationEvent
              - PasswordResetEvent
              - SecurityAlertEvent
          description: >-
            The email, by the event name its webhook delivery events carry, as
            listed by the list operation: PayslipGeneratedEvent,
            P45GeneratedEvent, P60GeneratedEvent, EmployeePensionEnrolmentEvent,
            ReportReadyEvent, WebhookEndpointFailingEvent,
            WebhookEndpointDisabledEvent, UserInvitedEvent,
            EmailVerificationEvent, PasswordResetEvent, SecurityAlertEvent.
        - name: pageSize
          in: query
          required: false
          description: 'How many versions to return: 1 to 50, default 20.'
          schema:
            type: integer
            minimum: 1
            maximum: 50
            default: 20
        - name: paginationToken
          in: query
          required: false
          description: >-
            The `paginationToken` the previous page returned; leave it out for
            the first page.
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/EmailWordingRevisionListResponseResponseBody
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ObjectResponseBody'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ObjectResponseBody'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ObjectResponseBody'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ObjectResponseBody'
      security:
        - X-Auth-Token: []
components:
  schemas:
    EmailWordingRevisionListResponseResponseBody:
      type: object
      required:
        - message
      properties:
        message:
          $ref: '#/components/schemas/MessageWithTokenResponse'
        validationIssues:
          type: array
          items:
            $ref: '#/components/schemas/ValidationIssue'
          nullable: true
        content:
          $ref: '#/components/schemas/EmailWordingRevisionListResponseContentResponse'
      additionalProperties: false
    ObjectResponseBody:
      type: object
      required:
        - message
      properties:
        message:
          $ref: '#/components/schemas/MessageWithTokenResponse'
        validationIssues:
          type: array
          items:
            $ref: '#/components/schemas/ValidationIssue'
          nullable: true
      additionalProperties: false
    MessageWithTokenResponse:
      type: object
      required:
        - text
        - token
      properties:
        text:
          type: string
        token:
          type: string
        tokenArguments:
          type: array
          items:
            $ref: '#/components/schemas/ValidationIssueArgument'
          nullable: true
      additionalProperties: false
    ValidationIssue:
      type: object
      required:
        - field
        - reason
        - reasonToken
      properties:
        field:
          type: string
        reason:
          type: string
        reasonToken:
          type: string
        reasonTokenArguments:
          type: array
          items:
            $ref: '#/components/schemas/ValidationIssueArgument'
          nullable: true
      additionalProperties: false
    EmailWordingRevisionListResponseContentResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/EmailWordingRevisionListResponse'
        metadata:
          $ref: '#/components/schemas/ContentMetadataResponse'
      additionalProperties: false
    ValidationIssueArgument:
      type: object
      required:
        - name
      properties:
        name:
          type: string
        value: {}
      additionalProperties: false
    EmailWordingRevisionListResponse:
      type: object
      required:
        - revisions
      properties:
        revisions:
          type: array
          items:
            $ref: '#/components/schemas/EmailWordingRevisionResponse'
        paginationToken:
          type: string
          nullable: true
      additionalProperties: false
    ContentMetadataResponse:
      type: object
      required:
        - dateFormat
        - dateTimeFormat
      properties:
        dateFormat:
          type: string
        dateTimeFormat:
          type: string
        paginationToken:
          type: string
          nullable: true
      additionalProperties: false
    EmailWordingRevisionResponse:
      type: object
      required:
        - revisionId
        - wording
        - createdDate
        - createdBy
      properties:
        revisionId:
          type: string
        wording:
          $ref: '#/components/schemas/EmailWording'
        enabled:
          type: boolean
          nullable: true
        createdDate:
          type: string
          format: date-time
        createdBy:
          type: string
      additionalProperties: false
    EmailWording:
      type: object
      properties:
        subject:
          type: string
          nullable: true
        heading:
          type: string
          nullable: true
        intro:
          type: string
          nullable: true
        closing:
          type: string
          nullable: true
        buttonLabel:
          type: string
          nullable: true
      additionalProperties: false
  securitySchemes:
    X-Auth-Token:
      type: apiKey
      description: Your access token (raw token, no Bearer prefix)
      name: X-Auth-Token
      in: header

````

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