Sending Email
Two Email Sending API Endpoints
The LuxSci API has two separate email sending API endpoints:
These endpoints are not the same. The sendSecureEmailOrSecureText endpoint was created first and supports both the sending of secure email messages and SecureText messages; however, it does not support very high volumes of sending. The sendEmail was added later as an API wrapper around SMTP sending and designed to fully support very high volumes of secure email sending. The sendSecureEmailOrSecureText is deprecated; sendEmail should be used when possible.
This table illustrates the differences between these ending endpoints.
API Call:
sendEmail
sendSecureEmailOrSecureText
Great for:
Secure High Volume Email
Large-scale email sending
Load-balanced emailing
Deprecated?
Deprecated
Can send SecureLine-encrypted email?
Yes
Yes
Messages sent from:
Email sending limit:
1000 messages/hour*
Maximum messages/API call
1000*
1
Maximum recipients/message
100*
100
Maximum messages/API call
1000*
100
Can send messages without SecureLine encryption (if permitted by your account settings)?
Yes
No
Can send SecureText messages
Yes
Yes
Sending user must have SMTP permissions with LuxSci?
Yes
No
Outbound SMTP server load balancing support?
Yes
N/A
Outbound SMTP server failover support?
Yes
N/A
Outbound messages queued if SMTP servers are down; sent when they are back up?
Yes
N/A
*Can be modified on dedicated API servers. Note: if you have a dedicated API sending server and would like to make more than 6000 API calls/day, please contact support to have your API usage limits increased to meet your needs.
Differences between sendEmail and sendSecureEmailOrSecureText endpoints
The sendEmail API endpoint has some functional differences from the sendSecureEmailOrSecureText endpoint in terms of how it is called.
- No TLS. The “no_tls_only” flag is not available in this API call. However, you can use custom subject or body text to trigger “No TLS Only” email delivery, just like you would when sending using directly via SMTP.
- Opt Out. You can use subject text to trigger “SecureLine Opt Out,” just like you would when sending using directly via SMTP.
- Attachments and multiple messages. You can send multiple messages, each of which may contain attachments. The attachments are uploaded as separate parts of your API POST and each is given a “name”. Each unique attachment must have a unique name. I.e., you should not try to send 2 messages in the same API call, which each have a different attachment with the same name.
However, if you are sending the same attachment in multiple messages in the same API call, you can include that attachment once and reference it by name from each message that will include it. I.e., you can send 1000 messages. Those 1000 messages may each include the same 1 MB attachment. You include that attachment once in the API call and reference it by name in each of the 1000 message objects. So, instead of uploading 1000 MB of data, you only upload just over 1 MB of data.