SendEmail Sending Failure

Problem

When attempting to send an email using the SendEmail API command, you receive the following error:

Sending Failed. Please see documentation.

Cause

The API command cannot send the specified email template type for the messagename parameter.

The SendEmail API command can send the following email template types:

  • General
  • Invoice
  • Support
  • Product
  • Domain
  • Affiliate

It cannot send any of the following email template types:

  • User
  • Invite
  • Notification
  • Admin

Solution

If you are sending an custom email template, perform the following steps to resolve the issue:

  1. Create a new email template as one of the supported email types.
  2. Update the messagename value in the API request to the name of the new email template.

If you are attempting to send one of the stock email templates, you may wish to consider using a different method to send the message.

troubleshooting troubleshooting-article email-sending email-templates whmcs-api

Last modified: 2025 July 28