Raise a ticket
Raise a ticket from your own system: an order problem, a form, an internal tool.
Only category is required. Every ticket belongs to a business: conversation_id pins the ticket to a thread and inherits its contact and business; contact_id links a contact without a thread and inherits the contact's business; otherwise pass business_id (a key restricted to exactly one business inherits that one). A ticket that would land without a business is refused with validation_failed, because business-less tickets are visible to workspace admins only.
conversation_id, contact_id and business_id must belong to your workspace (404 not_found otherwise; deleted contacts count as missing). A business_id that contradicts the thread's or contact's business is refused; omit it to inherit theirs. A contact_id that is not the conversation's contact is refused with validation_failed; omit it when you pass conversation_id.
Fans out a ticket.created webhook and an in-app notification, exactly like a flow-raised ticket.
Request
- Base URL: https://app.blueticked.com
- URL: https://app.blueticked.com/api/v1/tickets
- Auth: HTTP bearer
Request body
Example request
{
"category": "Refund request",
"title": "Order 552 arrived damaged",
"priority": "high",
"note": "Customer sent photos. Refund pre-approved by Sam.",
"contact_id": "ff506e53-e2f0-4d92-884a-dab77d628bad",
"business_id": "22222222-2222-4222-9222-222222222222"
}Response
Success
Example response
{
"request_id": "req_b2e3d610e10f1b07468721ee98f0e1d2"
}Changes
No recorded changes to this operation across all 1 revision of this API.