Start a ThriveDesk conversation from a server-side application without exposing an API token.
Create a conversation under the inbox that should own the ticket. Keep the bearer token on your server and deduplicate submissions before calling ThriveDesk.
curl -X POST "https://api.thrivedesk.com/v1/inboxes/3f7c1e94-2b6a-4d0e-8c5f-9a1b2c3d4e5f/conversations" \
-H "Authorization: Bearer $THRIVEDESK_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to": "[email protected]",
"status": "Active",
"subject": "Order INV-1042 arrived damaged",
"message": "The customer reported a cracked screen.",
"contact": {
"name": "Jane Cooper",
"company": "Acme Inc"
}
}'Validate the email and message in your application, escape untrusted HTML, and store your own submission ID before sending.
401/403: token or workspace access is invalid.404: the inbox does not exist or is unavailable to the token.422: inspect errors and correct the submitted fields.5xx: reconcile before retrying because the conversation may already exist.