Skip to main content
Open a request — the collaboration thread people settle a commission question in. Optionally about one statement: pass statement_user_id and statement_period together, and the request opens attached to that month’s payslip, exactly as it does from the statement page in the web app. The caller is the request’s author, and message is posted in their name. The request opens with its author as the only member; add people to it, close it or reassign it from the Qobra web app. Attachments are not supported here. Available only where the Qobra write tools beta is enabled. Every write is recorded in the audit trail as the Qobra MCP agent.

Parameters

Body

string
required
Title of the request, as it reads on the requests board — ‘January commission looks low’. Keep it short; the detail goes in message.
string
First message to post in the thread, written as the caller. Omit to open the request with an empty thread.
string
Id or exact email of the user whose statement the request is about. Pass it together with statement_period, or neither — a request need not be about a statement.
string
Period of the statement the request is about, as YYYY-MM (e.g. ‘2026-03’). Pass it together with statement_user_id.

Response

Body

object
The request as it now exists — the same row list_requests returns, so the id can be reused straight away. See list_requests for the full field breakdown.
object
The first message, when one was posted with the request; null when the request was opened with no message.