curl --request POST \
--url https://api.cloudhumans.com/cloudchat/v1/accounts/{accountId}/automation-rules/confirm-create \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'cloudchat-instance: <cloudchat-instance>' \
--data '
{
"proposal_token": "eyJfcmFpbHMiOnsiZGF0YSI6eyJqdGkiOiI0YjEw..."
}
'import requests
url = "https://api.cloudhumans.com/cloudchat/v1/accounts/{accountId}/automation-rules/confirm-create"
payload = { "proposal_token": "eyJfcmFpbHMiOnsiZGF0YSI6eyJqdGkiOiI0YjEw..." }
headers = {
"cloudchat-instance": "<cloudchat-instance>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'cloudchat-instance': '<cloudchat-instance>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({proposal_token: 'eyJfcmFpbHMiOnsiZGF0YSI6eyJqdGkiOiI0YjEw...'})
};
fetch('https://api.cloudhumans.com/cloudchat/v1/accounts/{accountId}/automation-rules/confirm-create', 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.cloudhumans.com/cloudchat/v1/accounts/{accountId}/automation-rules/confirm-create",
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([
'proposal_token' => 'eyJfcmFpbHMiOnsiZGF0YSI6eyJqdGkiOiI0YjEw...'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"cloudchat-instance: <cloudchat-instance>"
],
]);
$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.cloudhumans.com/cloudchat/v1/accounts/{accountId}/automation-rules/confirm-create"
payload := strings.NewReader("{\n \"proposal_token\": \"eyJfcmFpbHMiOnsiZGF0YSI6eyJqdGkiOiI0YjEw...\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("cloudchat-instance", "<cloudchat-instance>")
req.Header.Add("Authorization", "Bearer <token>")
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.cloudhumans.com/cloudchat/v1/accounts/{accountId}/automation-rules/confirm-create")
.header("cloudchat-instance", "<cloudchat-instance>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"proposal_token\": \"eyJfcmFpbHMiOnsiZGF0YSI6eyJqdGkiOiI0YjEw...\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cloudhumans.com/cloudchat/v1/accounts/{accountId}/automation-rules/confirm-create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["cloudchat-instance"] = '<cloudchat-instance>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"proposal_token\": \"eyJfcmFpbHMiOnsiZGF0YSI6eyJqdGkiOiI0YjEw...\"\n}"
response = http.request(request)
puts response.read_body{
"automation_rule": {
"id": 9,
"name": "Auto-close stale conversations",
"description": "Closes conversations idle for 7 days.",
"event_name": "conversation_updated",
"active": true,
"order_id": 1,
"conditions": [
"<unknown>"
],
"actions": [
"<unknown>"
],
"managed_by": null,
"execution_delay": null,
"delay_trigger": null,
"folder_id": null,
"created_at": "2026-05-02T11:04:17.000Z",
"updated_at": "2026-08-10T14:32:05.123Z"
}
}{
"error": {
"code": "bad_request",
"message": "The request is malformed.",
"details": [
{
"field": "base",
"code": "invalid_proposal",
"message": "The proposal token is invalid, expired, already used or belongs to another proposal. Propose the change again."
}
]
}
}{
"error": {
"code": "unauthorized",
"message": "Authentication is required. Send a valid Bearer token in the Authorization header."
}
}{
"error": {
"code": "forbidden",
"message": "You are not allowed to perform this action."
}
}{
"error": {
"code": "not_found",
"message": "Resource could not be found."
}
}{
"error": {
"code": "conflict",
"message": "The request conflicts with the current state of the resource.",
"details": [
{
"field": "base",
"code": "stale_proposal",
"message": "The rules changed after the proposal was made. Read them again and propose the change again."
}
]
}
}{
"message": "API rate limit exceeded"
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred. Please try again later."
}
}Confirm an automation rule
Second half of creating a rule. Send back only the proposal_token from proposeAutomationRuleCreate; the rule saved is exactly the one that was previewed, created off and placed after the last rule of its event at the moment of the confirm. The token is consumed by this call. If any rule of the same event was created, changed or removed after the proposal, nothing is written and the call answers 409 stale_proposal: propose again, so the preview and its warnings reflect the rules as they are now. Administrator only — an agent token gets a 403.
curl --request POST \
--url https://api.cloudhumans.com/cloudchat/v1/accounts/{accountId}/automation-rules/confirm-create \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'cloudchat-instance: <cloudchat-instance>' \
--data '
{
"proposal_token": "eyJfcmFpbHMiOnsiZGF0YSI6eyJqdGkiOiI0YjEw..."
}
'import requests
url = "https://api.cloudhumans.com/cloudchat/v1/accounts/{accountId}/automation-rules/confirm-create"
payload = { "proposal_token": "eyJfcmFpbHMiOnsiZGF0YSI6eyJqdGkiOiI0YjEw..." }
headers = {
"cloudchat-instance": "<cloudchat-instance>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'cloudchat-instance': '<cloudchat-instance>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({proposal_token: 'eyJfcmFpbHMiOnsiZGF0YSI6eyJqdGkiOiI0YjEw...'})
};
fetch('https://api.cloudhumans.com/cloudchat/v1/accounts/{accountId}/automation-rules/confirm-create', 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.cloudhumans.com/cloudchat/v1/accounts/{accountId}/automation-rules/confirm-create",
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([
'proposal_token' => 'eyJfcmFpbHMiOnsiZGF0YSI6eyJqdGkiOiI0YjEw...'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"cloudchat-instance: <cloudchat-instance>"
],
]);
$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.cloudhumans.com/cloudchat/v1/accounts/{accountId}/automation-rules/confirm-create"
payload := strings.NewReader("{\n \"proposal_token\": \"eyJfcmFpbHMiOnsiZGF0YSI6eyJqdGkiOiI0YjEw...\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("cloudchat-instance", "<cloudchat-instance>")
req.Header.Add("Authorization", "Bearer <token>")
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.cloudhumans.com/cloudchat/v1/accounts/{accountId}/automation-rules/confirm-create")
.header("cloudchat-instance", "<cloudchat-instance>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"proposal_token\": \"eyJfcmFpbHMiOnsiZGF0YSI6eyJqdGkiOiI0YjEw...\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cloudhumans.com/cloudchat/v1/accounts/{accountId}/automation-rules/confirm-create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["cloudchat-instance"] = '<cloudchat-instance>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"proposal_token\": \"eyJfcmFpbHMiOnsiZGF0YSI6eyJqdGkiOiI0YjEw...\"\n}"
response = http.request(request)
puts response.read_body{
"automation_rule": {
"id": 9,
"name": "Auto-close stale conversations",
"description": "Closes conversations idle for 7 days.",
"event_name": "conversation_updated",
"active": true,
"order_id": 1,
"conditions": [
"<unknown>"
],
"actions": [
"<unknown>"
],
"managed_by": null,
"execution_delay": null,
"delay_trigger": null,
"folder_id": null,
"created_at": "2026-05-02T11:04:17.000Z",
"updated_at": "2026-08-10T14:32:05.123Z"
}
}{
"error": {
"code": "bad_request",
"message": "The request is malformed.",
"details": [
{
"field": "base",
"code": "invalid_proposal",
"message": "The proposal token is invalid, expired, already used or belongs to another proposal. Propose the change again."
}
]
}
}{
"error": {
"code": "unauthorized",
"message": "Authentication is required. Send a valid Bearer token in the Authorization header."
}
}{
"error": {
"code": "forbidden",
"message": "You are not allowed to perform this action."
}
}{
"error": {
"code": "not_found",
"message": "Resource could not be found."
}
}{
"error": {
"code": "conflict",
"message": "The request conflicts with the current state of the resource.",
"details": [
{
"field": "base",
"code": "stale_proposal",
"message": "The rules changed after the proposal was made. Read them again and propose the change again."
}
]
}
}{
"message": "API rate limit exceeded"
}{
"error": {
"code": "internal_error",
"message": "An unexpected error occurred. Please try again later."
}
}Authorizations
Headers
Your Cloud Chat instance ID — an integer, fixed for your company, told at onboarding. The API overview explains how instances work, how to find yours, and the errors a wrong or missing value produces.
1
Path Parameters
Your Cloud Chat account. It has to be an account your token grants membership on, and it has to live on the instance in the cloudchat-instance header — the two travel together. Account numbers are only unique within an instance, so the same number is a different company on another instance. Usually a mismatched pair fails closed with a 401, because your user does not exist on the other instance — but if your identity happens to exist on both, the call succeeds against the other company's data, silently. Read it and you are looking at the wrong help center; write it and you have stored into the wrong account. Send the two values that were given to you together, and never try a number to see what answers.
1