---
title: "Create Plan Set Request"
method: POST
path: "/tenants/{tenant_id}/plan_set_requests"
tags: ["Plan Sets"]
---

# Create Plan Set Request

`POST /tenants/{tenant_id}/plan_set_requests`

## Request

- Base URL: `https://api-sandbox.aurorasolar.com`
- URL: `https://api-sandbox.aurorasolar.com/tenants/{tenant_id}/plan_set_requests`
- Auth: HTTP bearer

Create a new plan set request.

---

[block:callout]
{
  "type": "warning",
  "body": "Please note that the Plan Set Requests API is in limited release at this time, and is subject to change. If you are interested in accessing this API, please contact your Aurora account team."
}
[/block]
A plan set request contains information about a project necessary for Aurora to create a plan set document.

Creating a new plan set request requires the following:
- The id of a design that is ready to install. The design must include modules, and will be more accurate if the stringing and components are already present.
- The project that the design is associated with must have at least one image or document uploaded to the project as a project asset (see [Create Project Asset](ref:createprojectasset)).

All new plan set requests are created in `draft` status. See [Plan Sets](ref:plan-sets) for additional information on statuses.

## Path parameters

- `tenant_id` string, uuid, required

## Request body

- object
  - `plan_set_request` object, required: Plan set request to create.
    - `project_information` object
      - `ahj_notes_or_setbacks` string: Notes relating to AHJ requirements or setback requirements.
      - `contractor_name` string: Project contractor name.
      - `contractor_license_number` string: License number for project contractor.
      - `contractor_license_type` string: License type for project contractor.
      - `contractor_address` string: Mailing address for project contractor.
      - `contractor_phone` string: Phone number for project contractor.
    - `electrical_information` object, required
      - `main_panel_location` string, required: The location of the main service panel.
      - `main_bus_rating` 30 | 40 | 50 | 60 | 70 | 80 | 100 | 125 | 150 | 200 | 225 | 400, required: Busbar rating of the main service panel, in amperes. Must be a positive number.
      - `main_breaker_rating` 15 | 20 | 25 | 30 | 35 | 40 | 45 | 50 | 60 | 70 | 80 | 90 | 100 | 110 | 125 | 150 | 175 | 200 | 225 | 400: Amperage rating of the main service panel disconnect.
      - `service_type` 'single-phase-3-wire-120-240v' | 'single-phase-2-wire-120-240v' | '3-phase-4-wire-208v' | '3-phase-3-wire-480v': The type of wiring and phase configuration supplying power to the structure from the utility.
      - `feeder_type` 'overhead' | 'underground' | 'pole-mounted' | 'ct-cabinet' | 'other': The way the service conductors are fed to the structure.
      - `utility_meter_location` 'north-interior' | 'north-exterior' | 'south-interior' | 'south-exterior' | 'east-interior' | 'east-exterior' | 'west-interior' | 'west-exterior' | 'ne-interior' | 'ne-exterior' | 'nw-interior' | 'nw-exterior' | 'se-interior' | 'se-exterior' | 'sw-interior' | 'sw-exterior' | 'basement' | 'garage' | 'barn' | 'pole-mounted' | 'main-floor' | 'roof-top': Location of the utility meter in relation to the structure.
      - `existing_grounding` 'ground-rod' | 'cold-water-pipe' | 'ufer' | 'other': The existing means of electrical grounding for the structure.
      - `existing_grounding_location` string: Location of the existing grounding means.
      - `main_service_panel_manufacturer` string: The manufacturer of the main service panel.
      - `main_panel_upgrade` boolean: To indicate if a main panel upgrade is desired in the plan set design.
      - `main_panel_upgrade_bus_rating` 30 | 40 | 50 | 60 | 70 | 80 | 100 | 125 | 150 | 200 | 225 | 400: Busbar rating of the new main service panel to be installed, in amperes.
      - `main_panel_upgrade_main_breaker_rating` 15 | 20 | 25 | 30 | 35 | 40 | 45 | 50 | 60 | 70 | 80 | 90 | 100 | 110 | 125 | 150 | 175 | 200 | 225 | 400: Main service panel disconnect rating of the new main service panel to be installed, in amperes.
      - `electrical_notes` string: Any relevant notes about the electrical configuration.

## Response `200`

Plan Set Request successfully created.

- object
  - `plan_set_request` object
    - `project_information` object
      - `ahj_notes_or_setbacks` string: Notes relating to AHJ requirements or setback requirements.
      - `contractor_name` string: Project contractor name.
      - `contractor_license_number` string: License number for project contractor.
      - `contractor_license_type` string: License type for project contractor.
      - `contractor_address` string: Mailing address for project contractor.
      - `contractor_phone` string: Phone number for project contractor.
    - `electrical_information` object
      - `main_panel_location` string, required: The location of the main service panel.
      - `main_bus_rating` 30 | 40 | 50 | 60 | 70 | 80 | 100 | 125 | 150 | 200 | 225 | 400, required: Busbar rating of the main service panel, in amperes. Must be a positive number.
      - `main_breaker_rating` 15 | 20 | 25 | 30 | 35 | 40 | 45 | 50 | 60 | 70 | 80 | 90 | 100 | 110 | 125 | 150 | 175 | 200 | 225 | 400: Amperage rating of the main service panel disconnect.
      - `service_type` 'single-phase-3-wire-120-240v' | 'single-phase-2-wire-120-240v' | '3-phase-4-wire-208v' | '3-phase-3-wire-480v': The type of wiring and phase configuration supplying power to the structure from the utility.
      - `feeder_type` 'overhead' | 'underground' | 'pole-mounted' | 'ct-cabinet' | 'other': The way the service conductors are fed to the structure.
      - `utility_meter_location` 'north-interior' | 'north-exterior' | 'south-interior' | 'south-exterior' | 'east-interior' | 'east-exterior' | 'west-interior' | 'west-exterior' | 'ne-interior' | 'ne-exterior' | 'nw-interior' | 'nw-exterior' | 'se-interior' | 'se-exterior' | 'sw-interior' | 'sw-exterior' | 'basement' | 'garage' | 'barn' | 'pole-mounted' | 'main-floor' | 'roof-top': Location of the utility meter in relation to the structure.
      - `existing_grounding` 'ground-rod' | 'cold-water-pipe' | 'ufer' | 'other': The existing means of electrical grounding for the structure.
      - `existing_grounding_location` string: Location of the existing grounding means.
      - `main_service_panel_manufacturer` string: The manufacturer of the main service panel.
      - `main_panel_upgrade` boolean: To indicate if a main panel upgrade is desired in the plan set design.
      - `main_panel_upgrade_bus_rating` 30 | 40 | 50 | 60 | 70 | 80 | 100 | 125 | 150 | 200 | 225 | 400: Busbar rating of the new main service panel to be installed, in amperes.
      - `main_panel_upgrade_main_breaker_rating` 15 | 20 | 25 | 30 | 35 | 40 | 45 | 50 | 60 | 70 | 80 | 90 | 100 | 110 | 125 | 150 | 175 | 200 | 225 | 400: Main service panel disconnect rating of the new main service panel to be installed, in amperes.
      - `electrical_notes` string: Any relevant notes about the electrical configuration.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Provided design was not found.
- `409`: A plan set request already exists for the project.
- `422`: Unprocessable Entity

## Changes

- **2026-11-03** `97a7ad8a993a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/aurorasolar/apis/sync-api/changes/tenants/:tenant_id/plan_set_requests/post.md)

---

[API](https://skmtc.dev/aurorasolar/apis/sync-api.md) - [All operations](https://skmtc.dev/aurorasolar/apis/sync-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aurorasolar/apis/sync-api/revisions/97a7ad8a993a?raw)