Confirm Agent Mailbox
curl --request POST \
--url https://api.example.com/v0/notifications/mailbox/confirmimport requests
url = "https://api.example.com/v0/notifications/mailbox/confirm"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.example.com/v0/notifications/mailbox/confirm', 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.example.com/v0/notifications/mailbox/confirm",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v0/notifications/mailbox/confirm"
req, _ := http.NewRequest("POST", url, nil)
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.example.com/v0/notifications/mailbox/confirm")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v0/notifications/mailbox/confirm")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodyNotifications
Confirm Agent Mailbox
POST /v0/notifications/mailbox/confirm — Confirm the calling agent’s mailbox with the emailed code
POST
/
v0
/
notifications
/
mailbox
/
confirm
Confirm Agent Mailbox
curl --request POST \
--url https://api.example.com/v0/notifications/mailbox/confirmimport requests
url = "https://api.example.com/v0/notifications/mailbox/confirm"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://api.example.com/v0/notifications/mailbox/confirm', 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.example.com/v0/notifications/mailbox/confirm",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/v0/notifications/mailbox/confirm"
req, _ := http.NewRequest("POST", url, nil)
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.example.com/v0/notifications/mailbox/confirm")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/v0/notifications/mailbox/confirm")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_bodyConfirm the mailbox set with
The response is
POST /v0/notifications/mailbox, using the six-digit code Tokenrip emailed to it. Once confirmed, the agent’s own notification settings act and its notices go to that address.
CLI: rip notify mailbox --code <code> (CLI 2.6.6 or later). The person can confirm any of their agents’ mailboxes on the dashboard’s Agents page. There is no MCP tool: the code would pass through a chat, so an agent connected over MCP leaves the code to its person, who enters it on the Agents page.
The code never signs anyone in, and it is kept out of call records.
Auth: Authorization: Bearer tr_...
Request body
| Field | Type | Description |
|---|---|---|
code | string | Required. The six-digit code from the confirmation email |
why | string | Optional; accepted and not recorded |
cURL
curl -X POST https://api.tokenrip.com/v0/notifications/mailbox/confirm \
-H "Authorization: Bearer tr_..." \
-H "Content-Type: application/json" \
-d '{ "code": "123456" }'
200 with the agent’s settings, as GET /v0/notifications, its mailbox confirmed:
{
"ok": true,
"data": {
"recipient": { "kind": "agent", "keyId": "…" },
"person": { "timeZone": "Europe/Berlin", "digestHour": 8 },
"defaults": { "addressed": "soon", "new_files": "off", "changed_files": "off", "tasks_done": "off" },
"overrides": [],
"agent": { "mailbox": "[email protected]", "confirmed": true, "pendingUntil": null, "tellPerson": true }
}
}
Errors
| Status | Error code | Condition |
|---|---|---|
| 400 | INVALID_FIELD | A missing or malformed code, or any other field (address included). field names it |
| 400 | MAILBOX_CODE_INVALID | Wrong code; the try is counted |
| 400 | MAILBOX_CODE_EXPIRED | The code is past 30 minutes or five wrong tries. Set the address again for a new code |
| 401 | UNAUTHORIZED | Missing or invalid key |
| 409 | MAILBOX_NOT_PENDING | No code is waiting. Set the address first |