Send emails with attachments directly from your code.
This POST request listener bot is a simple yet powerful tool that can help you streamline your email communication process.
By accepting incoming POST requests, it enables you to easily send emails without the need to integrate with any external email provider right from your code as JSON.
Here's an example of a JSON POST request that you can send that our bot can handle:
{
"subject": "Example Email",
"body": "This is an example email sent via our POST request listener bot.",
"file_url": "https://your-server.com/example_file.csv"
}
In this example, the JSON object contains a title, a body, and a file URL. The bot will use this information to compose an email that includes the specified title and body, and attaches the file from the specified URL.
Once created the bot will generate a unique URL which will constanly listen for incoming POST requests, e.g.:
https://botster.io/data-post/1234-abc-5678
With this POST request format, you can easily send emails with attachments from your code by simply making an HTTP POST request to the bot's endpoint. Our bot will handle the rest and forward the email to your specified email address.
Attachment Size Limitations
While the bot is designed to handle a variety of file types and sizes, there are certain limitations that you should be aware of in order to ensure that your emails are sent successfully.
If the size of the attachment is less than or equal to 20 megabytes (MB), the attachment will be included in the email as expected. This is the most common limit for the majority of email providers after which emails usually bounce, hence the limitation.
If the size of the attachment is greater than 20 MB but less than or equal to 50 MB, the attachment will not be included in the email. Instead, the file will be downloaded to our servers, and a link to download the file will be provided in the email.
If the size of the attachment is greater than 50 MB, the attachment will not be downloaded to our servers. Instead, a link to the original source of the file on your server will be provided in the email.
It's important to note that these limits are in place to ensure the successful sending of emails and to prevent any potential issues that may arise from sending large attachments. Please make sure to consider these limits when using the bot to send emails with attachments.
If you have any questions or concerns regarding these limits or the use of the Botster POST Request Listener Bot, please don't hesitate to contact us. We're happy to help!
Code examples
To send an email with a file attachement right from your Python code you can use the following example:
import requests
# Set the Botster API endpoint and authentication token
BOTSTER_API_ENDPOINT = "https://botster.io/data-post/1234-abcd"
BOTSTER_AUTH_TOKEN = "your_auth_token_here"
# Define the email parameters
email_subject = "Example Email"
email_body = "This is an example email sent via our POST request listener bot."
file_url = "https://your-server.com/example_file.csv"
# Define the request payload
payload = {
"subject": email_subject,
"body": email_body,
"file_url": file_url
}
# Define the request headers, including the authentication token
headers = {
"Authorization": f"Bearer {BOTSTER_AUTH_TOKEN}",
"Content-Type": "application/json"
}
# Send the POST request to the Botster API
response = requests.post(BOTSTER_API_ENDPOINT, json=payload, headers=headers)
# Check the response status code and print the result
if response.status_code == 200:
print("Email sent successfully!")
else:
print(f"Failed to send email: {response.status_code} {response.reason}")