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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hostinger_mail_api-1.17.0.tar.gz (50.9 kB view details)

Uploaded Jul 28, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

hostinger_mail_api-1.17.0-py3-none-any.whl (102.7 kB view details)

Uploaded Jul 28, 2026 Python 3

File details

Details for the file hostinger_mail_api-1.17.0.tar.gz.

File metadata

Download URL: hostinger_mail_api-1.17.0.tar.gz
Upload date: Jul 28, 2026
Size: 50.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for hostinger_mail_api-1.17.0.tar.gz
Algorithm	Hash digest
SHA256	`459163b119a6cdad93c771ddb50aca1db91ee30b01dda9b7e1794a7a79156608`
MD5	`a26391f0ed5853dac15aae53a1e24b28`
BLAKE2b-256	`4fb29623b6d06b618e2eb5ef4f10e3e7c8fe6e5fd728f928fa71a4cd9ddcae3b`

See more details on using hashes here.

File details

Details for the file hostinger_mail_api-1.17.0-py3-none-any.whl.

File metadata

Download URL: hostinger_mail_api-1.17.0-py3-none-any.whl
Upload date: Jul 28, 2026
Size: 102.7 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for hostinger_mail_api-1.17.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`1d81b386955745049892476b4c3dffca92079a1d4bd8d7cd1911df74d9a6034e`
MD5	`cc6a46646f6e2850e050810588962ff8`
BLAKE2b-256	`4a6a739817ea437cc52d49d83b33a8d456a09a409448c655adce4658bc53d3bf`