> ## 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.

# Get your account's wording for one email

> One email's wording for your account, with the standard wording it inherits.



## OpenAPI

````yaml /api-reference/specs/notification.json get /customer/email-settings/{eventType}
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}:
    get:
      tags:
        - Account emails
      summary: Get your account's wording for one email
      description: >-
        One email's wording for your account, with the standard wording it
        inherits.
      operationId: GetAccountEmailSetting
      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.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EmailWordingSettingsResponseResponseBody'
        '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:
    EmailWordingSettingsResponseResponseBody:
      type: object
      required:
        - message
      properties:
        message:
          $ref: '#/components/schemas/MessageWithTokenResponse'
        validationIssues:
          type: array
          items:
            $ref: '#/components/schemas/ValidationIssue'
          nullable: true
        content:
          $ref: '#/components/schemas/EmailWordingSettingsResponseContentResponse'
      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
    EmailWordingSettingsResponseContentResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/EmailWordingSettingsResponse'
        metadata:
          $ref: '#/components/schemas/ContentMetadataResponse'
      additionalProperties: false
    ValidationIssueArgument:
      type: object
      required:
        - name
      properties:
        name:
          type: string
        value: {}
      additionalProperties: false
    EmailWordingSettingsResponse:
      type: object
      required:
        - eventType
        - level
        - audience
        - enabled
        - canBeSwitchedOff
        - wording
        - inherited
        - standard
        - placeholders
        - hasButton
        - locked
      properties:
        eventType:
          type: string
        level:
          type: string
          enum:
            - Organisation
            - Account
        audience:
          type: string
          enum:
            - Employees
            - AppUsers
            - Administrators
        enabled:
          type: boolean
        canBeSwitchedOff:
          type: boolean
        wording:
          $ref: '#/components/schemas/EmailWording'
        inherited:
          $ref: '#/components/schemas/EmailWording'
        standard:
          $ref: '#/components/schemas/EmailWording'
        placeholders:
          type: array
          items:
            $ref: '#/components/schemas/WordingPlaceholderResponse'
        hasButton:
          type: boolean
        locked:
          type: array
          items:
            type: string
        updatedDate:
          type: string
          format: date-time
          nullable: true
        updatedBy:
          type: string
          nullable: true
        standardFromAddress:
          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
    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
    WordingPlaceholderResponse:
      type: object
      required:
        - key
      properties:
        key:
          type: string
        sample:
          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.