Save Directorship Dividend

PUT /tenants/{tenant}/clients/{client}/mtd/dividends/{taxYear}/directorships/{employmentId}

Sends the directorship and dividend information for one employment — a full replacement of what HMRC hold against it.

Parameters

Name	Type	Description
tenant*	path string	The Tenant.Code
The Tenant.Code
client*	path string
employmentId*	path string
taxYear*	path string

Request Body*

SaveMtdDirectorshipDividendRequest

{
  "companyDirector": false,
  "closeCompany": false,
  "directorshipCeasedDate": "2024-01-01",
  "companyName": "string",
  "companyNumber": "string"
}

Responses

200 OK

MtdSubmissionReceiptDto

400 Bad Request

401 Unauthorized – Invalid or missing API key

404 Not Found