---
title: "Create tax summary test data"
method: POST
path: "/individual-paye-test-support/sa/{utr}/tax/annual-summary/{taxYear}"
tags: ["individual-paye-test-support"]
---

# Create tax summary test data

`POST /individual-paye-test-support/sa/{utr}/tax/annual-summary/{taxYear}`

## Request

- Base URL: `https://test-api.service.hmrc.gov.uk`
- URL: `https://test-api.service.hmrc.gov.uk/individual-paye-test-support/sa/{utr}/tax/annual-summary/{taxYear}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://test-api.service.hmrc.gov.uk/oauth/token`

Supports the [Individual Tax API](https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/individual-tax) by creating annual tax test data.

## Path parameters

- `utr` string, required
- `taxYear` string, required

## Headers

- `Accept` 'application/vnd.hmrc.2.0+json', required
- `Content-Type` 'application/json', required
- `Authorization` string, required

## Request body

- object: Create Individual Tax summary test data request

## Response `201`

Created

- object: Create Individual Tax summary test data request
  - `pensionsAnnuitiesAndOtherStateBenefits` object, required: Tax deducted from pensions, annuities and other state benefits.
    - `otherPensionsAndRetirementAnnuities` number: The amount of tax deducted from pensions (other than State Pension), retirement annuities and taxable trivial payments.
    - `incapacityBenefit` number: The amount of tax deducted from Incapacity Benefit.
  - `refunds` object, required
    - `taxRefundedOrSetOff` number: The amount of Income Tax refunded or set off by HMRC or Jobcentre Plus.
  - `employments` object[], required: An unordered list of zero or more employments for which the taxpayer had tax deducted in the given tax year.
    - `employerPayeReference` string, required: The employer’s PAYE reference.
    - `taxTakenOffPay` number, required: The amount of UK tax deducted from pay under this employment.

---

[API](https://skmtc.dev/hmrc/apis/paye-des-stub.md) - [All operations](https://skmtc.dev/hmrc/apis/paye-des-stub/llms.txt) - [OpenAPI document](https://skmtc.dev/hmrc/apis/paye-des-stub/revisions/244ce19b887f?raw)