---
title: "Create contract"
method: POST
path: "/customers/{customerID}/contracts"
tags: ["Contracts"]
---

# Create contract

`POST /customers/{customerID}/contracts`

Creates a draft contract for the specified customer. Requires the caller to be the direct parent (T1 for a T2-level contract, T2 for a T3-level contract). Write access requires a role without contractsReadOnly; user API tokens must include the matching permission in their scope.

## Path parameters

- `customerID` string, required

## Request body

- MTSContractInput — Contract create/update payload. Full field-level validation is applied server-side.
  - `name` string, required
  - `startDate` string, date-time, required
  - `endDate` string, date-time, nullable
  - `renewalPolicy` 'auto' | 'manual' | 'fixed', required
  - `invoicesEmail` string, email, required
  - `contractUpdatesEmail` string, email, required
  - `billingProfile` object, required — The billing profile (name, country, state, city, address, zip).
  - `managementAccounts` string[]
  - `billingRules` object[]
  - `priceBooks` object[]
  - `customLineItems` object[]

## Response `201`

Created - The contract draft was created.

- CreateContractResponse — The result of creating a contract or contract version.
  - `contractId` string
  - `version` integer
  - `status` string
  - `message` string
  - `timestamp` string, date-time

## Other responses

- `400` — Bad Request - The server cannot process the request, often due to a malformed request.
- `401` — Unauthorized - Invalid API key.
- `403` — Forbidden - The client is not authorized to perform the request.

---

[API](https://skmtc.dev/doit/apis/doit-cloud-intelligence.md) · [All operations](https://skmtc.dev/doit/apis/doit-cloud-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doit/doit-cloud-intelligence/revisions/9416402fc119/schema)