Hostinger Mail API Python SDK

About

This is a Python SDK for the Hostinger API.

Requirements.

Python 3.9+

Installation & Usage

pip install

Setup new virtual environment (optional but recommended):

python3 -m venv venv
source venv/bin/activate

Install the package via pip:

pip install hostinger_mail_api

Then import the package:

import hostinger_mail_api

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import hostinger_mail_api

Getting Started

Please follow the installation procedure and then run the following:

import hostinger_mail_api
from hostinger_mail_api.rest import ApiException
from pprint import pprint


# Configure Bearer authorization: BearerAuth
configuration = hostinger_mail_api.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)


# Enter a context with an instance of the API client
with hostinger_mail_api.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = hostinger_mail_api.AccountApi(api_client)

    try:
        # Get the authenticated account
        api_response = api_instance.get_current_account()
        print("The response of AccountApi->get_current_account:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling AccountApi->get_current_account: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://api.mail.hostinger.com

Class	Method	HTTP request	Description
AccountApi	get_current_account	GET /api/v1/me	Get the authenticated account
FoldersApi	create_folder	POST /api/v1/mailboxes/{mailboxResourceId}/folders	Create folder
FoldersApi	delete_folder	DELETE /api/v1/mailboxes/{mailboxResourceId}/folders/{folder}	Delete folder
FoldersApi	list_folders	GET /api/v1/mailboxes/{mailboxResourceId}/folders	List folders
FoldersApi	update_folder	PUT /api/v1/mailboxes/{mailboxResourceId}/folders/{folder}	Update folder
MessagesApi	delete_all_messages	DELETE /api/v1/mailboxes/{mailboxResourceId}/folders/{folder}/messages	Delete all messages
MessagesApi	delete_message	DELETE /api/v1/mailboxes/{mailboxResourceId}/folders/{folder}/messages/{uid}	Delete message
MessagesApi	delete_messages	POST /api/v1/mailboxes/{mailboxResourceId}/folders/{folder}/messages/delete	Delete messages
MessagesApi	get_message	GET /api/v1/mailboxes/{mailboxResourceId}/folders/{folder}/messages/{uid}	Get message
MessagesApi	get_message_attachment	GET /api/v1/mailboxes/{mailboxResourceId}/folders/{folder}/messages/{uid}/attachments/{attachmentId}	Download message attachment
MessagesApi	get_message_source	GET /api/v1/mailboxes/{mailboxResourceId}/folders/{folder}/messages/{uid}/source	Get message source
MessagesApi	get_message_text	GET /api/v1/mailboxes/{mailboxResourceId}/folders/{folder}/messages/{uid}/text	Get message text content
MessagesApi	list_messages	GET /api/v1/mailboxes/{mailboxResourceId}/folders/{folder}/messages	List messages
MessagesApi	move_message	POST /api/v1/mailboxes/{mailboxResourceId}/folders/{folder}/messages/{uid}/move	Move message
MessagesApi	move_messages	POST /api/v1/mailboxes/{mailboxResourceId}/folders/{folder}/messages/move	Move messages
MessagesApi	patch_message	PATCH /api/v1/mailboxes/{mailboxResourceId}/folders/{folder}/messages/{uid}	Update message flags
MessagesApi	search_messages	POST /api/v1/mailboxes/{mailboxResourceId}/folders/{folder}/messages/search	Search messages
MessagesApi	update_message_flags	POST /api/v1/mailboxes/{mailboxResourceId}/folders/{folder}/messages/flags	Update message flags
QuotaApi	get_quota	GET /api/v1/mailboxes/{mailboxResourceId}/quota	Get mailbox quota
SendApi	send_email	POST /api/v1/mailboxes/{mailboxResourceId}/send	Send email
WebhooksApi	create_webhook	POST /api/v1/mailboxes/{mailboxResourceId}/webhooks	Create webhook
WebhooksApi	delete_webhook	DELETE /api/v1/mailboxes/{mailboxResourceId}/webhooks/{webhook}	Delete webhook
WebhooksApi	get_webhook	GET /api/v1/mailboxes/{mailboxResourceId}/webhooks/{webhook}	Get webhook
WebhooksApi	list_webhooks	GET /api/v1/mailboxes/{mailboxResourceId}/webhooks	List webhooks
WebhooksApi	regenerate_webhook_secret	POST /api/v1/mailboxes/{mailboxResourceId}/webhooks/{webhook}/regenerate-secret	Regenerate webhook secret
WebhooksApi	test_webhook	POST /api/v1/mailboxes/{mailboxResourceId}/webhooks/{webhook}/test	Test webhook
WebhooksApi	update_webhook	PATCH /api/v1/mailboxes/{mailboxResourceId}/webhooks/{webhook}	Update webhook

Documentation For Models

• Error
• Pagination
• V1FolderMessagesCollection
• V1FolderMessagesDeleteBulkRequest
• V1FolderMessagesFlagsBulkRequest
• V1FolderMessagesFlagsRequest
• V1FolderMessagesMessage
• V1FolderMessagesMessageAddress
• V1FolderMessagesMessageAttachment
• V1FolderMessagesMessageText
• V1FolderMessagesMessageTextResource
• V1FolderMessagesMoveBulkRequest
• V1FolderMessagesMoveRequest
• V1FolderMessagesResource
• V1FolderMessagesSearchRequest
• V1FolderMessagesUpdateFlagsResult
• V1FolderMessagesUpdateFlagsResultData
• V1FolderMessagesUpdateFlagsResultDataFailedInner
• V1FoldersCollection
• V1FoldersCreateRequest
• V1FoldersFolder
• V1FoldersResource
• V1FoldersUpdateRequest
• V1MeMailbox
• V1MeResource
• V1MeResourceData
• V1QuotaQuota
• V1QuotaQuotaResource
• V1QuotaResource
• V1SendAttachment
• V1SendRequest
• V1WebhooksCollection
• V1WebhooksCreateRequest
• V1WebhooksResource
• V1WebhooksResourceWithSecret
• V1WebhooksTestResult
• V1WebhooksTestResultData
• V1WebhooksUpdateRequest
• V1WebhooksWebhook
• V1WebhooksWebhookWithSecret