---
title: "Create Submission"
method: POST
path: "/v1/submissions"
tags: ["v1", "submissions"]
---

# Create Submission

`POST /v1/submissions`

## Request

- Base URL: `https://thrustlab.com`
- URL: `https://thrustlab.com/v1/submissions`
- Auth: HTTP bearer

Create a new community-contribution submission.

Propose a motor or battery for inclusion in the public catalog.

Body fields: component_type (motor|battery), name, manufacturer, data_json
(type-specific spec map), source_url, notes (optional).

Motor data_json.R is the PHASE-TO-PHASE winding resistance in ohms — the
datasheet value, what a meter reads across two motor leads. This matches
the component spec_json.R convention, so an approved submission's
data_json copies verbatim into a catalog spec (2026-07-16 unification;
data_json was previously per-phase). Curation note: add_motor takes
terminal milliohms, so a motortoolbox import is R x 1000.

Returns the new submission resource (201) with status="submitted".

A component.submitted webhook event fires for every successful create.

## Request body

- SubmissionCreateBody
  - `component_type` string, required
  - `data_json` object, required
  - `manufacturer` string, required
  - `name` string, required
  - `notes` string, nullable
  - `source_url` string, required

## Response `201`

Successful Response

- SubmissionResource
  - `component_type` string, required
  - `created_at` string, date-time, required
  - `credit_reward` integer, required
  - `data_json` object, required
  - `id` string, required
  - `manufacturer` string, required
  - `name` string, required
  - `notes` string, nullable, required
  - `object` string
  - `reviewed_at` string, date-time, nullable, required
  - `reviewer_notes` string, nullable, required
  - `source_url` string, required
  - `status` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thrustlab/apis/thrustlab-api.md) · [All operations](https://skmtc.dev/thrustlab/apis/thrustlab-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thrustlab/apis/thrustlab-api/revisions/c19717e52529?raw)