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

# Create annual income summary test data

`POST /individual-paye-test-support/sa/{utr}/income/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}/income/annual-summary/{taxYear}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://test-api.service.hmrc.gov.uk/oauth/token`

Supports the [Individual Income API](https://developer.service.hmrc.gov.uk/api-documentation/docs/api/service/individual-income) by creating annual income 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 Income summary test data request

## Response `201`

Created

- object: Create Individual Income summary test data request
  - `pensionsAnnuitiesAndOtherStateBenefits` object, required: Income from pensions, annuities and other state benefits.
    - `otherPensionsAndRetirementAnnuities` number: The amount of income from pensions (other than State Pension), retirement annuities and taxable trivial payments.
    - `incapacityBenefit` number: The amount of taxable Incapacity Benefit and contribution-based Employment and Support Allowance.
    - `jobseekersAllowance` number: The amount of income from Jobseeker’s Allowance.
    - `seissNetPaid` number: The amount of income from the Self-Employment Income Support Scheme.
  - `employments` object[], required: An unordered list of zero or more employments for which the taxpayer received an income in the given tax year.
    - `employerPayeReference` string, required: The employer’s PAYE reference.
    - `payFromEmployment` number, required: The amount of pay from this employment, taken from the P45 or P60.

---

[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)