NAME

WWW::MailboxOrg - Perl client for Mailbox.org API

VERSION

version 0.001

SYNOPSIS

use WWW::MailboxOrg;

my $api = WWW::MailboxOrg->new(
    user     => 'test@example.tld',
    password => 'secret123',
);

# Authenticate and get session
$api->login;

# List accounts
my $accounts = $api->account->list;

# Get domain info
my $domain = $api->domain->get(domain => 'example.com');

DESCRIPTION

WWW::MailboxOrg provides a Perl interface to the Mailbox.org API. Uses JSON-RPC 2.0 over HTTPS with session-based authentication.

user

Mailbox.org username or email address.

password

Mailbox.org password.

token

Session token (HPLS-AUTH). Set after successful login.

base_url

Base URL for the API. Defaults to https://api.mailbox.org/v1.

login

$api->login;

Authenticate with username/password and store session token.

logout

$api->logout;

End the current session.

base

Returns WWW::MailboxOrg::API::Base for auth and search.

account

Returns WWW::MailboxOrg::API::Account for account management.

domain

Returns WWW::MailboxOrg::API::Domain for domain management.

mail

Returns WWW::MailboxOrg::API::Mail for email operations.

mailinglist

Returns WWW::MailboxOrg::API::Mailinglist for mailing list management.

blacklist

Returns WWW::MailboxOrg::API::Blacklist for blacklist management.

spamprotect

Returns WWW::MailboxOrg::API::Spamprotect for spam protection settings.

videochat

Returns WWW::MailboxOrg::API::Videochat for video chat rooms.

backup

Returns WWW::MailboxOrg::API::Backup for backup operations.

invoice

Returns WWW::MailboxOrg::API::Invoice for invoice access.

passwordreset

Returns WWW::MailboxOrg::API::Passwordreset for password reset.

validate

Returns WWW::MailboxOrg::API::Validate for email validation.

utils

Returns WWW::MailboxOrg::API::Utils for utility functions.

system

Returns WWW::MailboxOrg::API::System for system info (hello, test).

SEE ALSO

https://api.mailbox.org/v1/doc/methods/index.html - Mailbox.org API docs

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/getty/p5-www-mailboxorg/issues.

IRC

Join #perl-help on irc.perl.org or message Getty directly.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <getty@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.