API – Sending Emails
This article will discuss how to send emails using the API.
There are 2 steps. The first one is to create an email tool entity, and then the other one is to send it.
Sending an Email
This is done by sending a POST request to the /email.tool/next endpoint.
The body of the request will have the following values:
- companyEmailId – The ID of the company email to use in the “From” field
- emailSubject – The subject of the email
- emailContent – The content of the email
- loans – a JSON array of email ids to use
- query – an elastic search query object to use
Note: You only need loans or query, but you may submit both.
Below is an example request
POST https://loanpro.simnang.com/api/public/api/1/email.tool/next
{
"companyEmailId":1,
"emailSubject":"Subject Line",
"emailContent":"This is an email from [[v('tenant-name')]].",
"loans":[122]
}
The response will look similar to below
{
"d": {
"success": true
}
}
This response means that sending the email was successful. If there was an error, then the response would look similar to the following:
{
"error": {
"message": "Catchable Fatal Error: Argument 1 passed to Entity\\EmailTool\\EmailTool::linkLoan()
must be an instance of Entity\\Loan, null given, called in /home/deploy/codedeploy/webroot/api/module/Tools/src/Tools/Controller/
EmailToolController.php on line 123 and defined in /home/deploy/codedeploy/webroot/api/entities/Entity/EmailTool/EmailTool.php line 563",
"type": "ContextErrorException",
"code": 0
}
}
The above error signifies an invalid loan ID (ie. the loan id(s) given does not exist).
Note: If an email fails, it will be reprocessed to send again.