curl --request POST \
--url 'https://api.flashcat.cloud/channel/create?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"team_id": 3521074710131,
"channel_name": "Production Alerts",
"description": "Handles all production environment alerts",
"group": {
"method": "p",
"time_window": 10,
"window_type": "tumbling"
},
"auto_resolve_timeout": 86400,
"auto_resolve_mode": "trigger"
}
'import requests
url = "https://api.flashcat.cloud/channel/create?app_key="
payload = {
"team_id": 3521074710131,
"channel_name": "Production Alerts",
"description": "Handles all production environment alerts",
"group": {
"method": "p",
"time_window": 10,
"window_type": "tumbling"
},
"auto_resolve_timeout": 86400,
"auto_resolve_mode": "trigger"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
team_id: 3521074710131,
channel_name: 'Production Alerts',
description: 'Handles all production environment alerts',
group: {method: 'p', time_window: 10, window_type: 'tumbling'},
auto_resolve_timeout: 86400,
auto_resolve_mode: 'trigger'
})
};
fetch('https://api.flashcat.cloud/channel/create?app_key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.flashcat.cloud/channel/create?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'team_id' => 3521074710131,
'channel_name' => 'Production Alerts',
'description' => 'Handles all production environment alerts',
'group' => [
'method' => 'p',
'time_window' => 10,
'window_type' => 'tumbling'
],
'auto_resolve_timeout' => 86400,
'auto_resolve_mode' => 'trigger'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.flashcat.cloud/channel/create?app_key="
payload := strings.NewReader("{\n \"team_id\": 3521074710131,\n \"channel_name\": \"Production Alerts\",\n \"description\": \"Handles all production environment alerts\",\n \"group\": {\n \"method\": \"p\",\n \"time_window\": 10,\n \"window_type\": \"tumbling\"\n },\n \"auto_resolve_timeout\": 86400,\n \"auto_resolve_mode\": \"trigger\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/channel/create?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"team_id\": 3521074710131,\n \"channel_name\": \"Production Alerts\",\n \"description\": \"Handles all production environment alerts\",\n \"group\": {\n \"method\": \"p\",\n \"time_window\": 10,\n \"window_type\": \"tumbling\"\n },\n \"auto_resolve_timeout\": 86400,\n \"auto_resolve_mode\": \"trigger\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/channel/create?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"team_id\": 3521074710131,\n \"channel_name\": \"Production Alerts\",\n \"description\": \"Handles all production environment alerts\",\n \"group\": {\n \"method\": \"p\",\n \"time_window\": 10,\n \"window_type\": \"tumbling\"\n },\n \"auto_resolve_timeout\": 86400,\n \"auto_resolve_mode\": \"trigger\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"channel_id": 6294542005131,
"channel_name": "API Test Channel"
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter is not valid."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
}
}Create channel
Create a new channel for incident management.
curl --request POST \
--url 'https://api.flashcat.cloud/channel/create?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"team_id": 3521074710131,
"channel_name": "Production Alerts",
"description": "Handles all production environment alerts",
"group": {
"method": "p",
"time_window": 10,
"window_type": "tumbling"
},
"auto_resolve_timeout": 86400,
"auto_resolve_mode": "trigger"
}
'import requests
url = "https://api.flashcat.cloud/channel/create?app_key="
payload = {
"team_id": 3521074710131,
"channel_name": "Production Alerts",
"description": "Handles all production environment alerts",
"group": {
"method": "p",
"time_window": 10,
"window_type": "tumbling"
},
"auto_resolve_timeout": 86400,
"auto_resolve_mode": "trigger"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
team_id: 3521074710131,
channel_name: 'Production Alerts',
description: 'Handles all production environment alerts',
group: {method: 'p', time_window: 10, window_type: 'tumbling'},
auto_resolve_timeout: 86400,
auto_resolve_mode: 'trigger'
})
};
fetch('https://api.flashcat.cloud/channel/create?app_key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.flashcat.cloud/channel/create?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'team_id' => 3521074710131,
'channel_name' => 'Production Alerts',
'description' => 'Handles all production environment alerts',
'group' => [
'method' => 'p',
'time_window' => 10,
'window_type' => 'tumbling'
],
'auto_resolve_timeout' => 86400,
'auto_resolve_mode' => 'trigger'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.flashcat.cloud/channel/create?app_key="
payload := strings.NewReader("{\n \"team_id\": 3521074710131,\n \"channel_name\": \"Production Alerts\",\n \"description\": \"Handles all production environment alerts\",\n \"group\": {\n \"method\": \"p\",\n \"time_window\": 10,\n \"window_type\": \"tumbling\"\n },\n \"auto_resolve_timeout\": 86400,\n \"auto_resolve_mode\": \"trigger\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/channel/create?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"team_id\": 3521074710131,\n \"channel_name\": \"Production Alerts\",\n \"description\": \"Handles all production environment alerts\",\n \"group\": {\n \"method\": \"p\",\n \"time_window\": 10,\n \"window_type\": \"tumbling\"\n },\n \"auto_resolve_timeout\": 86400,\n \"auto_resolve_mode\": \"trigger\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/channel/create?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"team_id\": 3521074710131,\n \"channel_name\": \"Production Alerts\",\n \"description\": \"Handles all production environment alerts\",\n \"group\": {\n \"method\": \"p\",\n \"time_window\": 10,\n \"window_type\": \"tumbling\"\n },\n \"auto_resolve_timeout\": 86400,\n \"auto_resolve_mode\": \"trigger\"\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"channel_id": 6294542005131,
"channel_name": "API Test Channel"
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter is not valid."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
}
}Restrictions
| Aspect | Value |
|---|---|
| Rate limits | 1,000 requests/minute; 50 requests/second per account |
| Permissions | Channels Manage (on-call) |
Authorizations
App key issued from the Flashduty console under Account → APP Keys. Required on every public API call. Keep it secret — it grants the same access as the owning account.
Body
Parameters for creating a channel.
Owning team ID.
Channel name. 1 to 59 characters.
1 - 59Additional teams that can manage the channel. Up to 3 entries.
3Free-form description. Up to 500 characters.
500Default escalation rule applied to the channel. Omit to skip default escalation.
Show child attributes
Show child attributes
Alert grouping configuration.
Show child attributes
Show child attributes
Flapping detection configuration.
Show child attributes
Show child attributes
Auto-resolve timeout in seconds. 0 disables auto-resolve. Max 30 days.
0 <= x <= 2592000Auto-resolve timer reset mode.
trigger, update IDs of plugins (integrations) subscribed to this channel.
When true, the channel is visible only to its managing teams.
Disable outlier incident detection.
Disable automatic incident closing.
Allow external reporters to file incidents into this channel.
Response
Success
Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.
Was this page helpful?