Skip to content

Search documentation

Search pages and sections

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

  1. Install the plugin

    Upload the hulakimail folder to /wp-content/plugins/ or install it from Plugins → Add New, then activate it.

  2. Prepare Hulaki

    Verify your domain in Domains and create an API key with the emails:send scope in Credentials.

  3. Configure

    In WordPress, open Settings → Hulaki, paste the API key, set the From email (on your verified domain) and From name, and save.

  4. 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:

wp-config.php
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 wordpress in your Hulaki logs.

Tags, metadata & templates

In API mode, the hulakimail_payload filter lets you change the request before it’s sent:

functions.php
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 fires wp_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().
Deleting the plugin removes its options (including stored credentials) and the email log table.

Something unclear or missing? Tell us.