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

# Request Account Activation

> Initiates the process of account activation by sending an activation email to the user.



## OpenAPI

````yaml /open-api/en/accounts-version-1.json post /v1/accounts/account-activation-request
openapi: 3.0.1
info:
  title: OpenAPI definition
  version: v0
servers:
  - url: https://api.iklim.co
    description: Production server
  - url: https://api-test.iklim.co
    description: Test server
  - url: http://localhost:8080
    description: Local development environment with api gateway
security: []
tags:
  - name: User Accounts Service
    description: Manages Account Related Services
paths:
  /v1/accounts/account-activation-request:
    post:
      tags:
        - User Accounts Service
      summary: Request Account Activation
      description: >-
        Initiates the process of account activation by sending an activation
        email to the user.
      operationId: activateUserRequest
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AccountActivationRequest'
        required: true
      responses:
        '200':
          description: Account Activation Request Successfully Sent
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountActivationResponse'
        '400':
          description: Required Headers Missing or Payload Invalid for Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Bad Request Example:
                  summary: Example response
                  description: Bad Request Example
                  value:
                    timestamp: '2025-04-14T16:26:54.203118461'
                    status: 400
                    error: Bad Request
                    message: Missing X-Idempotency-Key header
                    path: /endpoint/uri/here
        '401':
          description: Unauthorized Request or Invalid Signature
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Unauthorized Example 1:
                  summary: Example response 1
                  description: Unauthorized Example 1
                  value:
                    timestamp: '2025-04-14T16:57:50.083970026'
                    status: 401
                    error: Unauthorized
                    message: Bad Credentials
                    path: /endpoint/uri/here
                Unauthorized Example 2:
                  summary: Example response 2
                  description: Unauthorized Example 2
                  value:
                    timestamp: '2025-04-14T16:57:50.083970026'
                    status: 401
                    error: Unauthorized
                    message: Invalid request signature
                    path: /auth/login
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
        '409':
          description: Redundant Request Made
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Conflict Example 1:
                  summary: Example response 1
                  description: Conflict Example 1
                  value:
                    timestamp: '2025-04-14T16:57:21.168927321'
                    status: 409
                    error: Conflict
                    message: Replay attack detected (nonce reused)
                    path: /endpoint/uri/here
                Conflict Example 2:
                  summary: Example response 2
                  description: Conflict Example 2
                  value:
                    timestamp: '2025-04-14T16:56:28.671809875'
                    status: 409
                    error: Conflict
                    message: Duplicate request detected (X-Idempotency-Key)
                    path: /endpoint/uri/here
        '500':
          description: Internal Server Error During Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Internal Server Error Example:
                  summary: Example response
                  description: Internal Server Error Example
                  value:
                    timestamp: '2025-04-14T16:58:10.414972912'
                    status: 500
                    error: Internal Server Error
                    message: An Error Occurred During Login
                    path: /endpoint/uri/here
components:
  schemas:
    AccountActivationRequest:
      required:
        - type
        - userId
      type: object
      properties:
        userId:
          type: string
          description: User Identifier for Account Activation
          format: uuid
          example: 296ff917-9b4b-4dc1-987d-2c17bdac7133
        type:
          type: string
          description: Account Type for Account Activation
          example: ORGANIZATION/INDIVIDUAL
          enum:
            - INDIVIDUAL
            - ORGANIZATION
        mobilePhoneNumber:
          type: string
          description: Mobile Phone Number for Account Activation
          example: '905321112233'
        location:
          type: string
          description: Address for Account Activation
          example: >-
            Cyberpark, Cyberplaza, A Blok, Kat 2, 06800, Bilkent, Ankara,
            Türkiye
        company:
          type: string
          description: Company Name for Account Activation
          example: TARLAIO İKLİM VE TARIM TEKNOLOJİLERİ A.Ş.
        industry:
          type: string
          description: Industry for Account Activation
          example: Yazılım Geliştirme, SaaS
        profilePictureUrl:
          type: string
          description: Profile Picture URL for Account Activation
          example: https://*******.png
        accountActivationPageLink:
          type: string
          description: Account Activation Page Link
          example: https://api-manager.iklim.co/activation/account
    AccountActivationResponse:
      type: object
      properties:
        userId:
          type: string
          description: User Identifier of Activated User
        accountId:
          type: string
          description: Account Identifier of Activated Account
        recipientEmail:
          type: string
          description: E-mail of Activated User
        tokenExpirationEpoch:
          type: integer
          description: Activation Token Expiration Time
          format: int64
          example: 1750423307000
        emailSent:
          type: boolean
          description: Was Activation E-mail Sent?
          example: true
    StandardErrorResponse:
      required:
        - error
        - message
        - path
        - status
        - timestamp
      type: object
      properties:
        timestamp:
          type: string
          description: Error Time Stamp
          format: date-time
        status:
          type: integer
          description: Error Status Code
          format: int32
        error:
          type: string
          description: Error Name
          example: Error Name
        message:
          type: string
          description: Error Description
          example: Error Message
        path:
          type: string
          description: Erroring Endpoint URI
          example: /endpoint/uri/here

````