Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Cubi Estate WhatsApp API
version: 0.1.0
description: 'Operations tagged Whatsapp across 2 of this provider''s published API definitions: cubi-estate-openapi.json, cubi-estate-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://mcp.cubi.estate
description: Host serving this spec (Swagger UI at https://mcp.cubi.estate/docs loads /openapi.json); also hosts the MCP endpoint https://mcp.cubi.estate/mcp
tags:
- name: Whats App
paths:
/whatsapp/webhook:
get:
summary: Meta WhatsApp Cloud API webhook verification handshake
description: 'Meta calls this once when you save the webhook config, with
`?hub.mode=subscribe&hub.verify_token=&hub.challenge=`. Echo back
the challenge iff the token matches WHATSAPP_WEBHOOK_VERIFY_TOKEN. Fail-closed:
unset secret → 503; wrong/missing token → 403.'
operationId: whatsapp_webhook_verify_whatsapp_webhook_get
responses:
'200':
description: Successful Response
content:
text/plain:
schema:
type: string
tags:
- Whats App
post:
summary: Meta WhatsApp Cloud API inbound message receiver (HMAC-validated)
description: 'Receives inbound WhatsApp events from Meta. Validates the
X-Hub-Signature-256 HMAC (sha256 of the raw body with the app secret,
fail-closed) BEFORE parsing, then fans messages out to background threads
and returns 200 fast (Meta retries on slow/non-200, and the search itself
takes ~17s). Phase 1 handles text messages (incl. /join); interactive
button/list replies are logged + deferred to Phase 2.'
operationId: whatsapp_webhook_receive_whatsapp_webhook_post
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Whatsapp Webhook Receive Whatsapp Webhook Post
tags:
- Whats App
x-refined-from:
- cubi-estate-openapi.json
- cubi-estate-openapi.yml