new starter declarations

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

path Parameters

employmentId

required

string <uuid>

The unique identifier (GUID) of the employment

Example: 4b30b724-26e1-4fcb-90f0-92936523133c

Request Body schema: application/vnd.api+json

New Starter Declaration to be created for an employment.

object

Responses

200

New Starter Declaration created successfully

default

General Error

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

200
default

application/vnd.api+json

{"links": {"self": "string"
},
"data": {"type": "newStarterDeclarations",
"attributes": {"employmentId": "4b30b724-26e1-4fcb-90f0-92936523133c",
"firstPaymentDate": "2024-01-15",
"annualAmount": 25000,
"taxCode": "1257L",
"taxCodeBasisWk1Mth1": false,
"taxCodeRegime": "rUK"
},
"links": {"self": "https://integrations.cintra.cloud/integrations/00000000-0000-0000-0000-000000000000/employment/4b30b724-26e1-4fcb-90f0-92936523133c"
}
}
}

➔ Next to organisation units