API Docs / Schemas / CreateEngagementRequest

CreateEngagementRequest

Request DTO for creating a new engagement

Properties

Name Type Description
clientCode*string

Code of the client this engagement belongs to

Code of the client this engagement belongs to

date*string

Date of the engagement

Date of the engagement

type*enum

ProposalAndEngagementLetter EngagementLetter

ProposalAndEngagementLetter EngagementLetter

recipientFirstNamestring

First name of the recipient for this engagement

First name of the recipient for this engagement

recipientLastNamestring

Last name of the recipient for this engagement

Last name of the recipient for this engagement

recipientEmailstring

Email address of the recipient for this engagement

Email address of the recipient for this engagement

proposalTemplateCodestring

Code of the template to use for the proposal document

Code of the template to use for the proposal document

lofETemplateCodestring

Code of the template to use for the letter of engagement (LofE) document

Code of the template to use for the letter of engagement (LofE) document

clientBillableServiceCodesarray of string

List of ClientBillableService codes to include in this engagement.

IMPORTANT: The system will create a historical snapshot of each ClientBillableService at its current state.
This snapshot is stored as JSON and preserves the service details even if the original
ClientBillableService is later modified or deleted.

The snapshot includes: name, description, price, billing frequency, start/end dates, and the
ClientBillableServiceCode for reference.

Example: ["CBS001", "CBS002", "CBS003"]

List of ClientBillableService codes to include in this engagement.

IMPORTANT: The system will create a historical snapshot of each ClientBillableService at its current state.
This snapshot is stored as JSON and preserves the service details even if the original
ClientBillableService is later modified or deleted.

The snapshot includes: name, description, price, billing frequency, start/end dates, and the
ClientBillableServiceCode for reference.

Example: ["CBS001", "CBS002", "CBS003"]

JSON Example

{
  "clientCode": "string",
  "date": "2024-01-01",
  "type": "ProposalAndEngagementLetter",
  "recipientFirstName": "string",
  "recipientLastName": "string"
}

Used By Operations