curl -X POST "https://core.wadial.com/api/v1/sessions" \
-H "Authorization: Bearer $WADIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"displayName":"Support line","deviceBrowser":"Chrome"}'
const response = await fetch("https://core.wadial.com/api/v1/sessions", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.WADIAL_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ displayName: "Support line", deviceBrowser: "Chrome" }),
});
const { data } = await response.json();
import os, requests
response = requests.post(
"https://core.wadial.com/api/v1/sessions",
headers={"Authorization": f"Bearer {os.environ['WADIAL_API_KEY']}"},
json={"displayName": "Support line", "deviceBrowser": "Chrome"},
)
data = response.json()["data"]
{
"data": {
"id": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
"sessionId": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
"displayName": "Support line",
"deviceBrowser": "Chrome",
"status": "created",
"meJid": null,
"connectedAt": null,
"entitlementId": null,
"expiresAt": null,
"createdAt": "2026-06-29T16:00:00.000Z",
"updatedAt": "2026-06-29T16:00:00.000Z",
"paired": false,
"active": true,
"connected": false,
"connectionState": "created",
"hasQr": false,
"health": { "status": "idle" },
"diagnostics": {}
}
}
API Reference
Create token
Create a WhatsApp session token.
POST
/
api
/
v1
/
sessions
curl -X POST "https://core.wadial.com/api/v1/sessions" \
-H "Authorization: Bearer $WADIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"displayName":"Support line","deviceBrowser":"Chrome"}'
const response = await fetch("https://core.wadial.com/api/v1/sessions", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.WADIAL_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ displayName: "Support line", deviceBrowser: "Chrome" }),
});
const { data } = await response.json();
import os, requests
response = requests.post(
"https://core.wadial.com/api/v1/sessions",
headers={"Authorization": f"Bearer {os.environ['WADIAL_API_KEY']}"},
json={"displayName": "Support line", "deviceBrowser": "Chrome"},
)
data = response.json()["data"]
{
"data": {
"id": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
"sessionId": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
"displayName": "Support line",
"deviceBrowser": "Chrome",
"status": "created",
"meJid": null,
"connectedAt": null,
"entitlementId": null,
"expiresAt": null,
"createdAt": "2026-06-29T16:00:00.000Z",
"updatedAt": "2026-06-29T16:00:00.000Z",
"paired": false,
"active": true,
"connected": false,
"connectionState": "created",
"hasQr": false,
"health": { "status": "idle" },
"diagnostics": {}
}
}
Creates a stable token your app can use for pairing, connection checks, message sends, and calls. WADial returns the
sessionId; store it and use it for later token operations.
Do not send a sessionId in the request body. WADial creates the token ID for you.
string
Human-readable token name.
string
Browser name shown in the WhatsApp linked-device list.
curl -X POST "https://core.wadial.com/api/v1/sessions" \
-H "Authorization: Bearer $WADIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"displayName":"Support line","deviceBrowser":"Chrome"}'
const response = await fetch("https://core.wadial.com/api/v1/sessions", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.WADIAL_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ displayName: "Support line", deviceBrowser: "Chrome" }),
});
const { data } = await response.json();
import os, requests
response = requests.post(
"https://core.wadial.com/api/v1/sessions",
headers={"Authorization": f"Bearer {os.environ['WADIAL_API_KEY']}"},
json={"displayName": "Support line", "deviceBrowser": "Chrome"},
)
data = response.json()["data"]
{
"data": {
"id": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
"sessionId": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
"displayName": "Support line",
"deviceBrowser": "Chrome",
"status": "created",
"meJid": null,
"connectedAt": null,
"entitlementId": null,
"expiresAt": null,
"createdAt": "2026-06-29T16:00:00.000Z",
"updatedAt": "2026-06-29T16:00:00.000Z",
"paired": false,
"active": true,
"connected": false,
"connectionState": "created",
"hasQr": false,
"health": { "status": "idle" },
"diagnostics": {}
}
}
Was this page helpful?
⌘I