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

# Get Integrations

> Returns the current account's integration configuration, including
WhatsApp, Telegram, and Email status. Masked secrets are returned
for configured channels.
Requires `integrations:view` permission.




## OpenAPI

````yaml GET /api/integrations
openapi: 3.1.0
info:
  title: Naturalead Integrations API
  version: 1.0.0
  description: >
    API for managing channel integrations (Email, Telegram, WhatsApp) in the
    Naturalead platform.

    All endpoints require API key authentication and are scoped to the caller's
    account.
servers:
  - url: '{baseUrl}'
    description: API server
    variables:
      baseUrl:
        default: http://localhost:3001
security:
  - BearerAuth: []
tags:
  - name: Integrations
    description: Channel integration configuration and verification
paths:
  /api/integrations:
    get:
      tags:
        - Integrations
      summary: Get integrations config
      description: |
        Returns the current account's integration configuration, including
        WhatsApp, Telegram, and Email status. Masked secrets are returned
        for configured channels.
        Requires `integrations:view` permission.
      operationId: getIntegrations
      responses:
        '200':
          description: Integration configuration
          content:
            application/json:
              schema:
                type: object
                properties:
                  configured:
                    type: boolean
                    description: Whether at least one channel is fully configured
                  webhookUrl:
                    type: string
                    description: The Meta WhatsApp webhook URL for this environment
                  telegramBotToken:
                    type: string
                    description: Masked token (shown as dots) if Telegram is configured
                  telegramConfigured:
                    type: boolean
                    description: Whether a Telegram bot token is set
                  wabaConnected:
                    type: boolean
                    description: Whether a WhatsApp Business Account is linked
                  wabaDisplayPhone:
                    type: string
                    description: Display phone number for the connected WABA
                  wabaConnectedAt:
                    type: string
                    format: date-time
                    description: When the WABA was connected
                  email:
                    type: object
                    description: Email integration details (present only if configured)
                    properties:
                      fromAddress:
                        type: string
                        format: email
                      fromName:
                        type: string
                      verified:
                        type: boolean
                      records:
                        type: array
                        items:
                          type: object
                          description: DNS records required for domain verification
                required:
                  - configured
        '500':
          $ref: '#/components/responses/InternalError'
components:
  responses:
    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
      required:
        - error
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Bearer token using an API key (format nl_live_* or nl_test_*)

````