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

# Set organization business hours

Configure the organization's business hours for each day of the week. Hours must be provided in UTC timezone and will not be converted automatically. The client application must handle timezone conversion based on user preferences.
Validates that hours are properly formatted, non-overlapping, and within valid time ranges.


## OpenAPI

````yaml https://api.getfernand.com/openapi.json post /organization/hours
openapi: 3.0.3
info:
  title: Fernand API Documentation
  version: '3.0'
  description: This is the documentation for the [Fernand](https://getfernand.com) API.
  termsOfService: https://getfernand.com/terms
  contact:
    name: Fernand Support
    url: https://getfernand.com
    email: support@getfernand.com
  x-logo:
    url: https://app.getfernand.com/images/favicon/icon_128.png
servers:
  - url: https://api.getfernand.com
    description: ''
    x-last-modified: 1764750693905
security:
  - apiKeyHeader: []
externalDocs:
  description: You can access our documentation online by visiting https://api.fernand.help
  url: https://api.fernand.help
paths:
  /organization/hours:
    post:
      tags:
        - Organizations
      summary: Set organization business hours
      description: >-
        Configure the organization's business hours for each day of the week.
        Hours must be provided in UTC timezone and will not be converted
        automatically. The client application must handle timezone conversion
        based on user preferences.

        Validates that hours are properly formatted, non-overlapping, and within
        valid time ranges.
      operationId: setOrganizationHours
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                timezone:
                  type: string
                  description: IANA timezone identifier (required).
                  example: America/New_York
                hours:
                  type: array
                  description: >-
                    Array of business hours by day (can be empty to clear
                    hours).
                  items:
                    type: object
                    properties:
                      day:
                        type: string
                        enum:
                          - monday
                          - tuesday
                          - wednesday
                          - thursday
                          - friday
                          - saturday
                          - sunday
                        description: Day of the week.
                        example: monday
                      start:
                        type: string
                        pattern: ^([01]?[0-9]|2[0-3]):[0-5][0-9]$
                        description: Opening time in HH:MM format (UTC).
                        example: '09:00'
                      end:
                        type: string
                        pattern: ^([01]?[0-9]|2[0-3]):[0-5][0-9]$
                        description: >-
                          Closing time in HH:MM format (UTC, must be after
                          start).
                        example: 1020
              required:
                - timezone
              example:
                timezone: America/New_York
                hours:
                  - day: monday
                    start: '09:00'
                    end: '17:00'
                  - day: tuesday
                    start: '09:00'
                    end: '17:00'
      responses:
        '200':
          description: Business hours updated successfully.
          content:
            application/json:
              schema:
                type: object
        '400':
          description: Invalid input or validation error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                    example: 400
                  error:
                    type: object
                    properties:
                      day:
                        type: string
                        description: Day that caused the error.
                        example: monday
                      reason:
                        type: string
                        description: Error message.
                        example: End hour must be higher than start for monday
components:
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      description: >-
        Authenticate your account by including your secret key in API requests.

        You can manage your API keys in the
        [Dashboard](https://app.getfernand.com/).


        Authentication to the API is performed by using the HTTP Header
        X-API-Key.
      name: X-API-Key
      in: header
      x-last-modified: 1764750344730

````