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
Request Body schema: application/vnd.api+json
New Starter Declaration to be created for an employment.
object |
Responses
201
New Starter Declaration Response
400
Bad Request
401
Unauthorized
403
Forbidden
404
Not Found
422
Unprocessable Entity
default
General Error
post/employment/newstarterdeclaration
Request samples
- Payload
- curl
- C#
- Java
- PHP
application/vnd.api+json
{- "data": {
- "type": "newStarterDeclarations",
- "attributes": {
- "employmentId": "4b30b724-26e1-4fcb-90f0-92936523133c",
- "firstPaymentDate": "2024-01-15",
- "annualAmount": 25000,
- "taxCode": "1257L",
- "taxCodeBasisWk1Mth1": false,
- "taxCodeRegime": "rUK"
}
}
}Response samples
- 201
- 400
- 401
- 403
- 404
- 422
- default
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"
}
}
}