HydraCore
API by router

Whatsapp channel

Whatsapp Status

Get WhatsApp channel status for an instance.

GET
/v1/instances/{instance_id}/channels/whatsapp
AuthorizationBearer <token>

In: header

Path Parameters

instance_idInstance Id
Formatuuid

Header Parameters

X-Api-Key?X-Api-Key

Response Body

curl -X GET "https://loading/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/channels/whatsapp" \  -H "X-Api-Key: string"
{
  "display_phone": "string",
  "enabled": true,
  "phone_number_id": "string",
  "status": "string",
  "webhook_url": "string"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Setup Whatsapp

Configure WhatsApp for an instance. Creates channel_endpoint record.

POST
/v1/instances/{instance_id}/channels/whatsapp
AuthorizationBearer <token>

In: header

Path Parameters

instance_idInstance Id
Formatuuid

Header Parameters

X-Api-Key?X-Api-Key
access_tokenAccess Token

WABA access token (stored encrypted via MCP credentials)

app_secretApp Secret

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

display_phone?Display Phone

Display phone number (e.g. +61400111222)

phone_number_idPhone Number Id

Meta phone number ID from Embedded Signup

verify_token?Verify Token

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

Response Body

curl -X POST "https://loading/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/channels/whatsapp" \  -H "X-Api-Key: string" \  -H "Content-Type: application/json" \  -d '{    "access_token": "string",    "app_secret": "string",    "phone_number_id": "string"  }'
{
  "display_phone": "string",
  "enabled": true,
  "phone_number_id": "string",
  "status": "string",
  "webhook_url": "string"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Teardown Whatsapp

Remove WhatsApp channel from instance.

DELETE
/v1/instances/{instance_id}/channels/whatsapp
AuthorizationBearer <token>

In: header

Path Parameters

instance_idInstance Id
Formatuuid

Header Parameters

X-Api-Key?X-Api-Key

Response Body

curl -X DELETE "https://loading/v1/instances/497f6eca-6276-4993-bfeb-53cbbbba6f08/channels/whatsapp" \  -H "X-Api-Key: string"
Empty
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}