---
title: "Create Part Vendor Association"
method: POST
path: "/v2/parts/vendors/associations"
tags: ["Routes", "Parts", "Vendor Associations"]
---

# Create Part Vendor Association

`POST /v2/parts/vendors/associations`

## Request

- Base URL: `{{server}}:{{port}}`
- URL: `{{server}}:{{port}}/v2/parts/vendors/associations`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/limblecmms/apis/limble-api-v2/docs/v2/parts/vendors/associations/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new manual vendor-part association. The part and vendor must both exist and the vendor must be accessible at the part's location.

Returns `201 Created` with the new association details. Returns `409 Conflict` if the association already exists.

## Request body

- object
  - `partID` integer, required: The ID of the part to associate.
  - `vendorID` integer, required: The ID of the vendor to associate.

## Response `201`

Created

- object
  - `relationID` integer
  - `partID` integer
  - `vendorID` integer
  - `associationType` string

## Other responses

- `400`: The request was malformed — either invalid JSON syntax or a validation failure (missing required field, wrong type, etc.).
- `401`: No `Authorization` header was provided on the request.
- `403`: The supplied credentials are invalid, the customer account is inactive, or the credentials do not have permission to perform this action.
- `404`: The referenced resource does not exist or is not visible to the authenticated customer.
- `409`: The request conflicts with the current state of the resource (e.g. a uniqueness constraint or a referenced parent that is in the wrong state).
- `429`: The per-minute or per-hour rate limit for this credential and method has been exhausted. Inspect the `X-RateLimit-*` headers to determine when to retry.
- `500`: An unhandled server-side error. The body message is generic (`System unavailable...`) when the underlying cause is a database fault; otherwise it reflects the raised error.

---

[API](https://skmtc.dev/limblecmms/apis/limble-api-v2.md) - [All operations](https://skmtc.dev/limblecmms/apis/limble-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/limblecmms/apis/limble-api-v2/revisions/488d795f846f?raw)