HydraCore
API by router

Whatsapp channel

Whatsapp Status

GET
/v1/instances/{instance_id}/channels/whatsapp

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

instance_id*Instance Id
Formatuuid

Header Parameters

X-Api-Key?string|null

Response Body

Successful Response

application/json
  1. response
display_phone?string|null
enabled*Enabled
phone_number_id?string|null
status*Status
webhook_url*Webhook Url
Example Request
curl -X GET 'https://example.com/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/channels/whatsapp'
Example Response
{  "display_phone": "string",  "enabled": true,  "phone_number_id": "string",  "status": "string",  "webhook_url": "string"}

Setup Whatsapp

POST
/v1/instances/{instance_id}/channels/whatsapp

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

instance_id*Instance Id
Formatuuid

Header Parameters

X-Api-Key?string|null

Request Body

application/json
  1. body
access_token*Access Token

WABA access token (stored encrypted via MCP credentials)

app_secret*App Secret

Meta App Secret for X-Hub-Signature-256 verification on POST webhooks

display_phone?|

Display phone number (e.g. +61400111222)

phone_number_id*Phone Number Id

Meta phone number ID from Embedded Signup

verify_token?|

Custom verify token for GET webhook challenge. Auto-generated if not provided.

Response Body

Successful Response

application/json
  1. response
display_phone?string|null
enabled*Enabled
phone_number_id?string|null
status*Status
webhook_url*Webhook Url
Example Request
curl -X POST 'https://example.com/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/channels/whatsapp' \  -H 'Content-Type: application/json' \  -d '{  "access_token": "string",  "app_secret": "string",  "phone_number_id": "string"}'
Example Response
{  "display_phone": "string",  "enabled": true,  "phone_number_id": "string",  "status": "string",  "webhook_url": "string"}

Teardown Whatsapp

DELETE
/v1/instances/{instance_id}/channels/whatsapp

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Path Parameters

instance_id*Instance Id
Formatuuid

Header Parameters

X-Api-Key?string|null

Response Body

Successful Response

Example Request
curl -X DELETE 'https://example.com/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/channels/whatsapp'
Example Response
Empty