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

# Check webhook status

> Returns webhook configuration for the authenticated user.
If sessionKey is provided, returns config for that specific session.
Otherwise returns all sessions.




## OpenAPI

````yaml /api-reference/openapi.yaml get /api/webhook
openapi: 3.1.0
info:
  title: Arlo Health MCP Server
  version: 1.0.0
  description: >
    Healthcare infrastructure for AI agents. Everything an agent needs

    to act in healthcare for its user.


    ## Overview


    This server exposes two interfaces:

    - **MCP** (Model Context Protocol) over streamable HTTP at `/` for AI agents

    - **REST API** at `/api/*` for bots, skills, and direct HTTP clients


    Both interfaces use the same tool handlers and authentication.


    ## Authentication


    OAuth 2.1 with PKCE. All `/api/*` endpoints require a Bearer token.


    Discovery endpoints (no auth required):

    - `/.well-known/oauth-protected-resource`

    - `/.well-known/oauth-authorization-server`

    - `/.well-known/mcp.json` (MCP Server Card)


    ## Service Regions


    Available in Ontario, Canada (`CA-ON`) and California, United States
    (`US-CA`).
  contact:
    name: Arlo Health
    url: https://arlohealth.ai
  license:
    name: Proprietary
    url: https://arlohealth.ai/tos
servers:
  - url: https://mcp.arlohealth.ai
    description: Production MCP Server
security:
  - oauth2:
      - openid
      - profile
      - email
      - offline_access
tags:
  - name: Discovery
    description: MCP and OAuth discovery endpoints (no auth required)
  - name: Profile
    description: User profile and patient information
  - name: Consultations
    description: Healthcare consultation management
  - name: Messaging
    description: Conversation messaging and media
  - name: Prescriptions
    description: Prescription and pharmacy management
  - name: Payment
    description: Billing and pay-per-use payment management
  - name: Webhooks
    description: Webhook registration and status
paths:
  /api/webhook:
    get:
      tags:
        - Webhooks
      summary: Check webhook status
      description: |
        Returns webhook configuration for the authenticated user.
        If sessionKey is provided, returns config for that specific session.
        Otherwise returns all sessions.
      operationId: getWebhookStatus
      parameters:
        - name: sessionKey
          in: query
          schema:
            type: string
          description: Check a specific session key. If omitted, returns all sessions.
      responses:
        '200':
          description: Webhook status
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/WebhookSessionStatus'
                  - $ref: '#/components/schemas/WebhookAllStatus'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    WebhookSessionStatus:
      type: object
      description: Webhook status for a specific session
      properties:
        configured:
          type: boolean
        sessionKey:
          type: string
        webhookUrl:
          type: string
          format: uri
        hasSecret:
          type: boolean
        hasDeliveryContext:
          type: boolean
        conversationSessionKey:
          type: string
        linkedAt:
          type: string
          format: date-time
        hint:
          type: string
    WebhookAllStatus:
      type: object
      description: Webhook status for all sessions
      properties:
        configured:
          type: boolean
        sessionCount:
          type: integer
        sessions:
          type: array
          items:
            type: object
            properties:
              sessionKey:
                type: string
              webhookUrl:
                type: string
                format: uri
              hasSecret:
                type: boolean
              hasDeliveryContext:
                type: boolean
              linkedAt:
                type: string
                format: date-time
              failureCount:
                type: integer
  responses:
    Unauthorized:
      description: Missing or invalid authentication
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
              needsAuth:
                type: boolean
  securitySchemes:
    oauth2:
      type: oauth2
      description: OAuth 2.1 with PKCE
      flows:
        authorizationCode:
          authorizationUrl: /oauth/authorize
          tokenUrl: /oauth/token
          scopes:
            openid: OpenID Connect
            profile: User profile
            email: Email address
            offline_access: Refresh tokens

````