---
title: "Add Subcontractor"
method: POST
path: "/vendors/subcontractors/add"
tags: ["vendors"]
---

# Add Subcontractor

`POST /vendors/subcontractors/add`

## Request

- Base URL: `https://api.kobaltlabs.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kobaltlabs.com/vendors/subcontractors/add`
- Auth: none declared

Add a new subcontractor company. This creates a company entry that can be linked to vendors.
Similar to adding a vendor but without creating a vendor relationship.

## Request body

- AddSubcontractorRequest
  - `company_name` string, required
  - `website_url` string, nullable

## Response `200`

OK

- Success
  - `message` string, required

## Other responses

- `201`: Successful Response
- `202`: Accepted
- `400`: Bad Request
- `422`: Validation Error

## Changes

- **2026-09-05** `f30e0fa3f746`: 4 breaking, 2 info
  - the response property `anyOf[subschema #2: Companies]/company_website` became optional for the status `201`
  - the response property `company_website` became optional for the status `202`
  - response property `anyOf[subschema #2: Companies]/company_website` list-of-types was widened by adding types `null` to media type `application/json` of response `201`
  - response property `company_website` list-of-types was widened by adding types `null` to media type `application/json` of response `202`
  - …2 more

[Operation history](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api/changes/vendors/subcontractors/add/post.md)

---

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