New starter declarations are used to set up tax coding information for new employees. This includes tax codes, annual amounts, and tax code regimes for payroll processing
Create a New Starter Declaration
Creates a new starter declaration for the specified employment. This endpoint processes tax coding information and creates the necessary records for payroll processing.
SecuritybearerAuth
Request
Responses
201
New Starter Declaration Response
post/employment/{employmentId}/newstarterdeclaration
Request samples
- Payload
- curl
- C#
- Java
- PHP
application/vnd.api+json
{- "data": {
- "type": "newStarterDeclarations",
- "attributes": {
- "firstPaymentDate": "2025-01-15",
- "annualAmount": 35000,
- "taxCode": "1257L",
- "taxCodeBasisWk1Mth1": false,
- "taxCodeRegime": "rUK"
}
}
}Response samples
- 201
application/vnd.api+json
{- "id": "a0bc1ba8-063e-c1fd-3e8f-6b5951f33e03",
- "data": {
- "type": "newStarterDeclarations",
- "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
- "attributes": {
- "employmentId": "4b30b724-26e1-4fcb-90f0-92936523133c",
- "firstPaymentDate": "2024-01-15",
- "annualAmount": 25000,
- "taxCode": "1257L",
- "taxCodeBasisWk1Mth1": false,
- "taxCodeRegime": "rUK"
}
}
}