> ## Documentation Index
> Fetch the complete documentation index at: https://docs.montra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# create_ticket

> Add a ticket to a Montra document.

Adds a new ticket to an existing document. `title` is the short label, `summary` is the one-line gist shown next to it, and `body` is the markdown implementation spec an agent reads before building.

Tickets created through the connector carry the same "manual" source as tickets a person adds in the app — they are hand-authored work items, not output of a generation job.

## Input

<ParamField body="documentId" type="string" required>
  Id of the Montra document the ticket belongs to (UUID).
</ParamField>

<ParamField body="title" type="string" required>
  Short title for the ticket. Trimmed; 1–300 characters.
</ParamField>

<ParamField body="summary" type="string">
  One-line gist of the ticket. Trimmed; up to 1000 characters.
</ParamField>

<ParamField body="body" type="string">
  Markdown implementation spec for the ticket.
</ParamField>

## Output

<ResponseField name="ticket" type="object" required>
  <Expandable title="properties">
    <ResponseField name="id" type="string" required>Id of the newly created ticket.</ResponseField>
    <ResponseField name="documentId" type="string" required>Id of the document the ticket belongs to.</ResponseField>
    <ResponseField name="title" type="string" required>Short title for the ticket.</ResponseField>
    <ResponseField name="summary" type="string" required>One-line gist shown next to the title. Empty string when none was given.</ResponseField>
    <ResponseField name="body" type="string" required>Markdown implementation spec. Empty string when none was given.</ResponseField>
    <ResponseField name="status" type="string" required>`todo` or `done`. New tickets start at `todo`.</ResponseField>
    <ResponseField name="sortRank" type="string" required>Opaque ordering key that places the ticket within its document. Empty for tickets created here.</ResponseField>
    <ResponseField name="timestampMs" type="number" required>Offset into the source recording, in milliseconds, that the ticket points at. `0` for tickets created here, which are not tied to a recording moment.</ResponseField>
    <ResponseField name="inputId" type="string" required>Id of the input whose generation produced the ticket. `null` for tickets created here.</ResponseField>
    <ResponseField name="createdAt" type="string" required>ISO 8601 creation timestamp.</ResponseField>
    <ResponseField name="updatedAt" type="string" required>ISO 8601 timestamp of the last change.</ResponseField>
  </Expandable>
</ResponseField>

## Notes

* The document must be in the workspace this connection is bound to; anything else reads as not found. See [workspace binding](/authentication#workspace-binding).
* To create the document first, use [`create_document`](/tools/create-document).
* Related: [`update_ticket`](/tools/update-ticket), [`get_ticket`](/tools/get-ticket), and the [agent workflow guide](/guides/agent-workflow).