---
title: "Create a TMS organization"
method: POST
path: "/api/v1/external/tms/organizations"
tags: ["TMS Organizations"]
---

# Create a TMS organization

`POST /api/v1/external/tms/organizations`

## Request

- Base URL: `https://api.wove.com`
- URL: `https://api.wove.com/api/v1/external/tms/organizations`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/wove/apis/wove-external-api/docs/api/v1/external/tms/organizations/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new TMS organization. The combination of (source, code) must be unique.

## Request body

- CreateTmsOrganizationRequest (unresolved $ref)

## Response `201`

Organization created successfully

- object
  - `success` boolean
  - `data` TmsOrganization (unresolved $ref)

## Other responses

- `400`: Invalid request or duplicate organization code
- `401` (unresolved $ref)
- `403`: Insufficient permissions - requires tms-organizations:write scope

---

[API](https://skmtc.dev/wove/apis/wove-external-api.md) - [All operations](https://skmtc.dev/wove/apis/wove-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wove/apis/wove-external-api/revisions/37290e267e07?raw)