AegeanBot Webhooks API

openapi: 3.2.0
info:
  title: Aegeanbot Com Webhooks API
  version: 0.1.0
  description: 'Operations tagged Webhooks across 2 of this provider''s published API definitions: app-aegeanbot-com-openapi.json, pms-aegeanbot-com-openapi.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Webhooks
paths:
  /webhooks/sendgrid:
    post:
      summary: Sendgrid Events
      description: 'SendGrid Event Webhook -> email_log delivery states (EMAIL_SETUP §4).

        Signature verified when SENDGRID_WEBHOOK_PUBLIC_KEY is set.'
      operationId: sendgrid_events_webhooks_sendgrid_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Webhooks
  /webhooks/clerk:
    post:
      summary: Clerk Webhook
      description: 'Clerk user.created -> GHL CRM contact tagged new-host (ghl_crm.py).

        Register in the Clerk dashboard with CLERK_WEBHOOK_SECRET as the signing key.'
      operationId: clerk_webhook_webhooks_clerk_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Webhooks
  /webhooks/inbound-email/{token}:
    post:
      summary: Concierge Inbound Email
      description: 'SendGrid Inbound Parse for concierge.aegeanbot.com (concierge spec §5):

        store the row, fire the Inngest event, nothing else. Inbound Parse has no

        signature, so the path carries INBOUND_PARSE_TOKEN. Non-2xx → SendGrid

        retries for up to 3 days, hence 500 when the event bus is unreachable.'
      operationId: concierge_inbound_email_webhooks_inbound_email__token__post
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Webhooks
  /webhooks/telnyx:
    post:
      summary: Telnyx Events
      description: 'Verified Telnyx SMS receive + delivery callbacks.


        Signature verification uses the untouched request bytes. The handler only

        performs identity lookup and idempotent database writes—never an LLM or an

        outbound SMS—so Telnyx receives its acknowledgement promptly.'
      operationId: telnyx_events_webhooks_telnyx_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Webhooks
  /webhooks/wati:
    post:
      summary: Wati Events
      description: WATI does not sign callbacks, so require a separate random URL secret.
      operationId: wati_events_webhooks_wati_post
      parameters:
      - name: token
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Webhooks
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
x-refined-from:
- app-aegeanbot-com-openapi.json
- pms-aegeanbot-com-openapi.json