Integrations
WordPress plugin
Deliver all WordPress email — WooCommerce, contact forms, password resets — through Hulaki via the API or SMTP.
WordPress sends mail with PHP’s mail() by default, which often lands in spam or never arrives. The Hulaki plugin replaces it for everything that uses wp_mail(), and keeps a log of the last 1,000 messages with one-click resend. Requires WordPress 5.7+ and PHP 7.4+.
Install & connect
Install the plugin
Upload the
hulakimailfolder to/wp-content/plugins/or install it from Plugins → Add New, then activate it.Prepare Hulaki
Verify your domain in Domains and create an API key with the
emails:sendscope in Credentials.Configure
In WordPress, open Settings → Hulaki, paste the API key, set the From email (on your verified domain) and From name, and save.
Test
Click Check connection, then Send test email. The message appears in the plugin log and in your Hulaki dashboard.
Keep secrets in wp-config.php
Constants override the stored settings and keep credentials out of the database:
define( 'HULAKIMAIL_API_KEY', 'hm_live_...' );
// SMTP mode only:
define( 'HULAKIMAIL_SMTP_PASSWORD', '...' );API or SMTP?
Use the API (default) unless you have a reason not to: it’s faster, records the Hulaki message ID for every send, supports open/click tracking toggles and works on hosts that block SMTP ports. SMTP mode points WordPress’s PHPMailer at smtp.hulakimail.com with an SMTP credential.
WooCommerce
- Set WooCommerce → Settings → Emails → From address to an address on your verified domain, or enable Force From in the Hulaki settings.
- HTML order emails and attachments (such as PDF invoices) are sent as-is.
- If emails are queued with Action Scheduler, make sure WP-Cron runs reliably (a real cron job hitting
wp-cron.php). - Messages are tagged
wordpressin your Hulaki logs.
Tags, metadata & templates
In API mode, the hulakimail_payload filter lets you change the request before it’s sent:
add_filter( 'hulakimail_payload', function ( $payload, $atts ) {
$payload['tags'][] = 'password-reset';
$payload['metadata'] = array( 'site' => 'shop' );
return $payload;
}, 10, 2 );Troubleshooting
- If Hulaki can’t be reached,
wp_mail()returns false and fireswp_mail_failed, and the error is logged. Enable Fallback to use the default WordPress mailer instead. - Another SMTP plugin active? Deactivate it — only one plugin should handle
wp_mail().
Something unclear or missing? Tell us.