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

# create_plan

> Create a compensation plan — the container its compensations hang off. The plan is created empty; add compensations with create_compensation.

Create a compensation plan — the container its compensations hang off.

The plan is created empty: no compensation, nobody attributed to it. Add
compensations with
[`create_compensation`](/mcp_documentation/tools/create_compensation), then
open the plan with [`get_plan`](/mcp_documentation/tools/get_plan) or find it
again in [`list_plans`](/mcp_documentation/tools/list_plans).

Available only where the Qobra write tools beta is enabled. Every write to the
live environment is recorded in the audit trail as the `Qobra MCP` agent;
writes to a sandbox are not audited.

## Parameters

<Accordion title="Body" defaultOpen>
  <ParamField body="name" type="string" required>
    Display name of the plan, as people will read it in Qobra — 'Enterprise
    AE 2026', 'SDR H1'.
  </ParamField>

  <ParamField body="section_id" type="string">
    Id of the section to file the plan under — the id a plan's section
    carries in list\_plans. Omit it to leave the plan unfiled. Never a
    section name.
  </ParamField>

  <ParamField body="sandbox_id" type="string">
    Id of the sandbox to create the plan in — the id list\_sandboxes
    returns. Omit it to create the plan in the live environment. Only a
    sandbox id is accepted here — never a sandbox name, and never the live
    environment's own id.
  </ParamField>
</Accordion>

## Response

<Accordion title="Body" defaultOpen>
  <ResponseField name="plan" type="object">
    The plan as it now exists — the same row list\_plans returns, so the id
    can be reused straight away.

    <Expandable title="object properties">
      <ResponseField name="id" type="string" />

      <ResponseField name="resource_url" type="string">
        Deep link to open this plan in the Qobra web app.
      </ResponseField>

      <ResponseField name="name" type="string" />

      <ResponseField name="archived" type="boolean" />

      <ResponseField name="section" type="object">
        The section the plan is filed under; null when unfiled.

        <Expandable title="object properties">
          <ResponseField name="id" type="string" />

          <ResponseField name="name" type="string" />
        </Expandable>
      </ResponseField>

      <ResponseField name="compensation_count" type="integer">
        Zero for a just-created plan.
      </ResponseField>
    </Expandable>
  </ResponseField>
</Accordion>