API Docs / Operations / CIS Details Requests / Create CIS Details Request

Create CIS Details Request

POST /tenants/{tenant}/contacts/{code}/cis-details-requests

Creates a pending request for the subcontractor and emails them a link to the public form where they enter their CIS details, with no account. With sdcStatementTitle, a pending SDC statement is created as well: the same email asks for both and the form leads on to the statement. 400 when the contact is not a CIS subcontractor, 409 when it already has an unfinished request.

Parameters

NameTypeDescription
tenant* path string

The tenant code (the organisation's URL stub)

The tenant code (the organisation's URL stub)

code* path string
{
  "email": "user@example.com",
  "sdcStatementTitle": "string"
}

Responses

400 Bad Request
application/problem+json
401 Unauthorized – Invalid or missing API key
403 Forbidden
application/problem+json
404 Not Found
application/problem+json
409 Conflict
application/problem+json