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

# Create employment history test data

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

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

## Response `201`

Created

- object: Create Individual Employment summary test data response
  - `employments` object[], required: An unordered list of one or more employments which the taxpayer had in the given tax year.
    - `employerPayeReference` string, required: The employer’s PAYE reference.
    - `employerName` string, required: The name of the employer.
    - `offPayrollWorkFlag` boolean: The value of OPW flag.

---

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