---
title: "Create service contract"
method: POST
path: "/service_contract"
---

# Create service contract

`POST /service_contract`

## Request body

- object
  - `service_contract` object — Service contract object
    - `contract_name` integer, required — Service contract name
    - `term_months` string, required — Contract term months
    - `start_date` string, date, required — Contract start date
    - `end_date` string, date — Contract end date
    - `prefix` string — Contract prefix
    - `contract_subtotal` integer — Contract subtotal
    - `activation_date` string, date — Contract activation date
    - `location_applicability` 'ANY' | 'FIXED' — Contract location availability
    - `approval_status` 'AWAIT_APPROVAL' | 'APPROVED' | 'REJECTED' — Approval status
    - `customer` string — Customer uid
    - `organization` string — Organization uid
    - `parent_contract` string — Parent contract uid
    - `contract_package` string — Service contract package uid
    - `template` string — Contract template uid
    - `attachments` object[] — Attachment Details
      - `file_name` string, required
      - `url` string, required
      - `file_size` integer
      - `visible_to_customer` boolean
    - `line_items` object[] — Line item details
      - `discount_type` string — Discount type
      - `product_id` string — Product id
      - `product_uid` string — Product uid
      - `name` string — Line item name
      - `quantity` integer — Line item quantity
      - `available_quantity` integer — Line item available quantity
      - `unit_price` integer — Line item unit price
      - `total` integer — total amount
      - `description` string — Line item description
      - `discount` integer — Discount amount
      - `image` string — product image
      - `brand` string — Product brand name
      - `specification` string — product specification
      - `uom` string — uom
      - `serial_nos` integer[] — serial nos
      - `has_custom_tax` boolean — Custom tax flag
      - `tax` object
        - `tax_name` string — Tax name
        - `tax_rate` integer — Tax rate
        - `tax_amount` integer — Tax amount
    - `tax` object[] — Tax uids
      - `tax_uid` string — Tax uid
    - `payment_history` object[] — Payment history details
      - `billing_date` string, date — Billing date
      - `due_date` string, date — Due date
      - `invoice_date` string, date — Invoice date
      - `total_amount` integer — Amount
      - `is_paid` boolean — is paid flag
    - `invoice_settings` object — Invoice setting detsils
      - `auto_generate` boolean — Auto generate flag
      - `payment_term` string — Invoice payment term uid
      - `invoice_template` string — Invoice template uid
      - `billing_period` string — Contract billing period uid
      - `generate_invoice_days` integer — Generate invoice days
    - `customer_address` object — Customer Address
      - `city` string
      - `state` string
      - `street` string
      - `country` string
      - `landmark` string
      - `zip_code` string
      - `geo_cordinates` number[]
      - `first_name` string
      - `last_name` string
      - `phone_number` string — Customer phone number
      - `email` string — Customer email
      - `label` string — Label
    - `billing_address` object — Organization Address
      - `city` string
      - `state` string
      - `street` string
      - `country` string
      - `landmark` string
      - `zip_code` string
      - `geo_cordinates` number[]
      - `first_name` string
      - `last_name` string
      - `phone_number` string — Customer phone number
      - `email` string — Customer email
      - `label` string — Label
    - `custom_fields` object — Custom field values
      - `label` string, required
      - `value` string, required
      - `type` string, required
      - `ref_uid` string
      - `module_name` 'JOB' | 'CUSTOMER' | 'EMPLOYEE' | 'ESTIMATE' | 'INVOICE' | 'PRODUCT' | 'PURCHASE_ORDER' | 'SERVICE_CONTRACT' | 'ASSET' | 'PROPERTY' | 'ORGANIZATION' | 'TEAM' | 'REQUEST' | 'PROJECT'
      - `hide_to_fe` boolean
      - `hide_field` boolean
      - `read_only` boolean
      - `group_name` string
      - `group_uid` string

## Response `200`

200

- object
  - `type` string
  - `message` string
  - `data` object
    - `contract_uid` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/zuper/apis/zuper-pro-api.md) · [All operations](https://skmtc.net/zuper/apis/zuper-pro-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zuper/zuper-pro-api/revisions/c7b8028a05de/schema)