Enviar um pedido de contacto
RegistosPOST /contact-requests
Stores a contact form submission for the platform team and notifies them. topic, name (up to 120 characters), organization (up to 160), email (up to 254, a plain address) and message (up to 2000) are required; phone is up to 40 characters, connections must not be negative, and locale is pt (default) or en. The body is at most 4096 bytes (413 PAYLOAD_TOO_LARGE). When the installation enables the bot challenge, an anonymous UI request must carry challenge_token (scope intake.contact): a missing token returns 403 CHALLENGE_REQUIRED and a rejected one 403 CHALLENGE_FAILED; a signed-in caller skips the challenge. At most 5 requests per IP address and 3 per e-mail address are accepted per hour; beyond that the response is 429 RATE_LIMITED with Retry-After. A request whose hidden website field is filled is answered 201 but not stored.
Corpo application/json
topicWhat the request is about (case-insensitive)
um de
sales,support,partnership,press,securitynameYour name
organizationOrganization you represent
emailReply address
phoneOptional phone number
connectionsOptional number of service connections your organization runs
messageYour message
localeLanguage to reply in
um de
pt,enwebsiteLeave empty. Hidden form field; a filled value marks the request as automated and it is not stored
challenge_tokenBot-challenge token when the challenge is enabled (anonymous callers). Only UI requests (browser headers, the dashboard, or X-Client mobile or desktop) are challenged; API requests never are.
Devolve
curl -X POST "$PUBLIC_API/contact-requests" \
-H "Content-Type: application/json" \
-d '{
"topic": "sales",
"name": "Ana Matsinhe",
"organization": "organization",
"email": "ana.matsinhe@example.org",
"phone": "+258841234567",
"connections": 0,
"message": "Leitura confirmada no local.",
"locale": "pt",
"website": "website",
"challenge_token": "challenge token"
}'
# Sem comando CLI equivalente; use cURL ou HTTP directo.
const res = await fetch("$PUBLIC_API/contact-requests", {
method: "POST",
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
"topic": "sales",
"name": "Ana Matsinhe",
"organization": "organization",
"email": "ana.matsinhe@example.org",
"phone": "+258841234567",
"connections": 0,
"message": "Leitura confirmada no local.",
"locale": "pt",
"website": "website",
"challenge_token": "challenge token"
})
});
const data = await res.json();
import requests
res = requests.post(
"$PUBLIC_API/contact-requests",
json={
"topic": "sales",
"name": "Ana Matsinhe",
"organization": "organization",
"email": "ana.matsinhe@example.org",
"phone": "+258841234567",
"connections": 0,
"message": "Leitura confirmada no local.",
"locale": "pt",
"website": "website",
"challenge_token": "challenge token"
}
)
data = res.json()
body := strings.NewReader(`{
"topic": "sales",
"name": "Ana Matsinhe",
"organization": "organization",
"email": "ana.matsinhe@example.org",
"phone": "+258841234567",
"connections": 0,
"message": "Leitura confirmada no local.",
"locale": "pt",
"website": "website",
"challenge_token": "challenge token"
}`)
req, _ := http.NewRequest("POST", "$PUBLIC_API/contact-requests", body)
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
{
"id": "pub_2N9GuTbc4N3Cen3kov12WlDEOBh",
"status": "new",
"created_at": "2026-11-19T09:30:00Z"
}