Skip to content

sendEmailToExternalUsers ​

Allows an INTERACT end user to send an email to users "external" to the platform e.g. HCP sending to patient and/or carer. Also works for sending to internal users. See: TP#15915.

Request ​

http
POST /rest/user/send/email/external

Headers ​

HeaderRequiredDescription
x-nextinteract-authtokenYesAuth token returned from loginUser
x-nextinteract-company-api-keyYesAdmin-specific API key UUID provided to company

Parameters ​

Multi-part form data request containing:

ParameterTypeRequiredDescription
toEmailAddressesstringYesComma-separated text array of email addresses to send to e.g one@one.com, two@two.com etc. Max 10 email addresses.
emailSubjectstringYesSubject of email. Max 255 chars.
emailBodystringNoHTML body of email. Max 30000 chars including HTML tags.
emailDisclaimerstringNoHTML email disclaimer. Max 4000 chars.
attachmentsfile(s)No1-M file attachments. Max 20Mb.

If you need help, let Aaron know as it's difficult to paste a binary multi-part form request in here.

Response ​

200 OK ​

HTTP 200 means it succeeded but if you must have a message then see below

JSON response:

json
{
"errorCode": 0,
"errorMsg": "OK"
}

Errors ​

ExceptionDescription
WSInvalidParameterExceptionSee Error Definitions
WSInvalidAuthTokenExceptionSee Error Definitions
WSCacheServiceExceptionSee Error Definitions
WSMaxFileUploadSizeExceptionSee Error Definitions
WSEmailServiceExceptionSee Error Definitions
WSRecordNotFoundExceptionSee Error Definitions
WSCompanyApiKeyNotActiveExceptionSee Error Definitions
WSIncorrectApiKeyTypeExceptionSee Error Definitions
WSInternalExceptionSee Error Definitions