/service/@id/uptime/channelsCreate an alert channel
A new channel awaits verification, except an email to the account owner's own verified address. verification.method names the next step: email_code (code in the email, valid 24 hours), telegram_link (open telegram_url within 10 minutes), test_message (Discord, Slack, webhook: call verify the channel to send a test message), zalo_link, zalo_otp. A webhook channel returns webhook_secret (whsec_…) once only. HTTP 201. A channel type outside the plan's limits.channels answers 403 entitlement_exceeded.
A Tino Uptime service route: call it with the service owner's sign-in token; the /v1 gateway (app tokens, personal tokens) does not expose Tino Uptime yet. See Getting started with Tino Uptime.
Authentication
Send the token in the header Authorization:
Authorization: Bearer <token>
Tokens that can call it: the Tino Uptime service owner's sign-in token (the tino.vn client area token).
Parameters
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | int | Required | Tino Uptime service ID |
Body (JSON)
| Name | Type | Required | Description |
|---|---|---|---|
kind | string | Required | `email`, `telegram`, `discord`, `slack`, `webhook` or `zalo`, within the plan's `limits.channels` |
name | string | Required | Channel name, 1–100 characters |
config | object | Optional | `address` for email; `url` (https) for Discord, Slack, webhook; Zalo: `consent: true` and `phone` (mobile number, verified by OTP) or no `phone` to link through the OA; Telegram needs none |
idempotency_key | string | Optional | 8–128 characters `A-Za-z0-9._:-`: resending the same key and body creates nothing new |
Response
Sample built from the Tino Uptime OpenAPI (Tino relays the answer as is inside data); values are examples.
Error codes
| Error code | Description |
|---|---|
404 · service_not_found, invalid method | The service does not belong to the signed-in account, or is not Tino Uptime. |
404 · service_not_linked | The service is no longer the customer's current Tino Uptime plan. |
403 · account_suspended | The Tino Uptime account is suspended: writes are blocked, GET still works. |
403 · entitlement_exceeded | Over a plan limit; details.resource names the limit. |
422 · validation_failed | Invalid data; details.field names the field. |
502 · network, invalid_response | The connection between Tino and Tino Uptime is interrupted: a Tino-side error, not a token problem. Retry later. |
Errors look like {"error": ["<CODE>"], "message", "details", "request_id"}; every code is in Getting started with Tino Uptime.