Connections and their health

GET /v1/connections

Building with AI? Connect it to your account over MCP: it checks your setup, creates webhooks and templates with your confirmation and writes the code for you. See how →

GET /v1/connections lists the account's numbers (read-only). Each carries its id (conn_…), its phoneNumberId (Meta's id for the number — the value the from field takes when sending), label/externalId (your reseller identity), displayPhone, and health: metaStatus (connected/pending/flagged/restricted/disconnected), qualityRating, messagingTier. The only thing mutable via the API is the reseller identity: PATCH /v1/connections/:id (label, externalId, monthlyMessageLimit, notes). To disconnect a number: DELETE /v1/connections/{id} (conn_… or your externalId), the same as «Disconnect» in the dashboard.

curl https://api.waiaconnect.com/v1/connections \
  -H "Authorization: Bearer wc_live_YOUR_API_KEY"
# → { "connections": [ { "id": "conn_…", "label": "…", "externalId": "…",
#       "displayPhone": "…", "metaStatus": "connected", "qualityRating": "…" } ] }

const res = await fetch("https://api.waiaconnect.com/v1/connections", {
  headers: { "Authorization": "Bearer wc_live_YOUR_API_KEY" }
});
const { connections } = await res.json();
for (const c of connections) console.log(c.id, c.metaStatus, c.qualityRating);

<?php
$ch = curl_init("https://api.waiaconnect.com/v1/connections");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Authorization: Bearer wc_live_YOUR_API_KEY"],
]);
$data = json_decode(curl_exec($ch), true);
foreach ($data["connections"] as $c) { echo $c["id"] . " " . $c["metaStatus"] . "\n"; }

import requests
res = requests.get("https://api.waiaconnect.com/v1/connections",
  headers={"Authorization": "Bearer wc_live_YOUR_API_KEY"})
for c in res.json()["connections"]:
    print(c["id"], c["metaStatus"], c["qualityRating"])

externalId is unique per account and travels in every webhook (envelope.connection.externalId) → you need no mapping table.