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

# Issue an API token

> Use your Access Key and Secret Key to issue an API token valid for one hour. Include the token in the Authorization header of requests that require authentication. Reuse it until it expires.



## OpenAPI

````yaml /en/api-reference/openapi.yaml post /authenticate
openapi: 3.0.3
info:
  title: Notifly API
  version: 1.0.0
  contact:
    email: contact@notifly.tech
servers:
  - url: https://api.notifly.tech
    description: Notifly API server
security: []
tags:
  - name: catalog
    x-group: Catalogs
paths:
  /authenticate:
    post:
      summary: authenticate
      operationId: authenticate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - accessKey
                - secretKey
              properties:
                accessKey:
                  type: string
                  description: >-
                    The project's Access Key. Each project has one Access Key.
                    Find it in the Notifly project settings.
                  example: example1234567890abcdef1234567890ab
                secretKey:
                  type: string
                  description: >-
                    The project's Secret Key. Each project has one Secret Key.
                    Find it in the Notifly project settings.
                  example: EXAMPLEabc9%
      responses:
        '200':
          description: Authentication succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SuccessResponse'
        '400':
          description: Client error, such as an invalid request or failed authentication.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClientErrorResponse'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    SuccessResponse:
      type: object
      properties:
        data:
          type: string
          description: Authentication token, valid for 1 hour.
          example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example
        error:
          type: string
          nullable: true
          description: null on success.
          example: null
    ClientErrorResponse:
      type: object
      properties:
        data:
          type: string
          nullable: true
          description: null on error.
          example: null
        error:
          type: string
          description: Error message
          example: Invalid Authorization Token
    ErrorResponse:
      type: object
      properties:
        data:
          type: string
          nullable: true
          description: null on error.
          example: null
        error:
          type: string
          description: Error message
        projectId:
          type: string
          nullable: true
          description: Project ID, included only for 500 errors.
          example: null
        durationMs:
          type: integer
          nullable: true
          description: Processing time in ms, included only for 500 errors.
          example: null

````

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