---
title: "Create CIS Deductions for Subcontractor"
method: POST
path: "/individuals/deductions/cis/{nino}/amendments"
---

# Create CIS Deductions for Subcontractor

`POST /individuals/deductions/cis/{nino}/amendments`

## Request

- Base URL: `https://test-api.service.hmrc.gov.uk`
- URL: `https://test-api.service.hmrc.gov.uk/individuals/deductions/cis/{nino}/amendments`
- Auth: OAuth 2
  - Authorization code: `https://api.service.hmrc.gov.uk/oauth/authorize`
  - Token URL: `https://api.service.hmrc.gov.uk/oauth/token` scopes: `write:self-assessment`

This endpoint allows a developer to create a customer’s CIS deductions that have been previously populated. A National Insurance number must be provided.
**This endpoint can only be used after the tax year has ended.**

### Test data
Scenario simulation using Gov-Test-Scenario headers is only available in the sandbox environment.

| Header Value (Gov-Test-Scenario) | Scenario                                                                                        |
|----------------------------------|-------------------------------------------------------------------------------------------------|
| N/A - DEFAULT                    | Simulates success response.                                                                     |
| DUPLICATE_SUBMISSION             | Simulates the scenario where CIS deductions already exists for this tax year.                   |
| OUTSIDE_AMENDMENT_WINDOW         | Simulates the scenario where request cannot be completed as it is outside the amendment window. |
| STATEFUL                         | Performs a stateful create.                                                                     |

## Path parameters

- `nino` string, required

## Headers

- `Authorization` string, required
- `Accept` string, required
- `Content-Type` string, required
- `Gov-Test-Scenario` string
- `suspend-temporal-validations` boolean

## Request body

- object
  - `fromDate` string, date, required: CIS tax year start date. The minimum tax year is 2020-21. The minimum tax year in Sandbox is 2019-20. Must conform to the format `YYYY-MM-DD`
  - `toDate` string, date, required: CIS tax year end date. The minimum tax year is 2020-21. The minimum tax year in Sandbox is 2019-20. Must conform to the format `YYYY-MM-DD`
  - `contractorName` string, required: The name of the contractor the subcontractor worked for. Must not be empty or contain only whitespace.
  - `employerRef` string, required: A unique identifier, the contractor reference number.
  - `periodData` object[], required: List of deductions. At least one item is required.
    - `deductionAmount` number, required: The amount of tax deducted by the contractor. This value must be between 0 and 99999999999.99 up to 2 decimal places.
    - `deductionFromDate` string, date, required: The From date when the deduction was made within the CIS tax year period. Must conform to the format `YYYY-MM-DD`
    - `deductionToDate` string, date, required: The To date when the deduction was made within the CIS tax year period. Must conform to the format `YYYY-MM-DD`
    - `costOfMaterials` number: The cost of materials incurred under CIS. This value must be between 0 and 99999999999.99 up to 2 decimal places.
    - `grossAmountPaid` number: The gross amount paid under CIS. This value must be between 0 and 99999999999.99 up to 2 decimal places.

## Response `200`

Success

- object
  - `submissionId` string, required: A unique identifier for the customer provided CIS deduction amendment.

## Other responses

- `400`: Bad request
- `403`: Forbidden

## Changes

- **2026-08-14** `77097460e998`: 1 info
  - added the new optional `header` request parameter `suspend-temporal-validations`

[Operation history](https://skmtc.dev/hmrc/apis/cis-deductions-mtd/changes/individuals/deductions/cis/:nino/amendments/post.md)

---

[API](https://skmtc.dev/hmrc/apis/cis-deductions-mtd.md) - [All operations](https://skmtc.dev/hmrc/apis/cis-deductions-mtd/llms.txt) - [OpenAPI document](https://skmtc.dev/hmrc/apis/cis-deductions-mtd/revisions/a0f7d1c5512d?raw)
