Company Logo

Help Center

Hey, what answers do you need?

Published: Oct 31, 2025, 10:14 PM
Published

Error Codes Library - Mailgun


This article includes a list of the possible errors you could encounter on Mailgun.


Mailgun:


CodeError MessageMeaningSolutionGlossary
400from parameter is missingThe sender's email address is not providedInclude the sender's email in the 'from' parameter'from' parameter: Sender's email address
400to parameter is missingThe receiver's email address is not providedInclude the receiver's email in the 'to' parameter'to' parameter: Receiver's email address
400message parameter is missingThe email body is not providedInclude the email body in the 'message' parameter'message' parameter: Email body
400‘message’ parameter is not a fileThe 'message' parameter is expected to be a file but isn'tProvide the message as a file'message' parameter: Email body, in this case expected as a file
400Need at least one of ‘text’ or ‘html’ parameters specifiedNeither plain text nor HTML versions of the email are providedInclude at least one of the 'text' or 'html' parameters'text'/'html' parameters: Plain text/HTML versions of the email
400Only one parameters ‘html’ or ‘template’ is allowedBoth 'html' and 'template' parameters are provided, but only one is allowedProvide either the 'html' or 'template' parameter, not both'html'/'template' parameters: HTML version of the email / Template for the email
400Send options (parameters starting with o:, h:, or v:) are limited to 16 kB totalThe send options provided exceed the 16 kB limitReduce the size of send options to less than 16 kB'o:', 'h:', 'v:' parameters: Send options for the email
400Too many recipients; max is 1000The email is addressed to more than 1000 recipientsLimit the number of recipients to 1000 or lessRecipients: The individuals or groups receiving the email
400Header name must be pure ASCII: <header-name>The header name contains non-ASCII charactersUse only ASCII characters in the header nameASCII: American Standard Code for Information Interchange, a character encoding standard
400<invalid-date> is not an RFC-2822 compliant dateThe provided date is not compliant with RFC-2822Ensure the date is formatted according to RFC-2822 standardsRFC-2822: Internet Message Format specification
400to parameter is not a valid address. please check documentationThe receiver's email address is invalidCheck and correct the format of the receiver's email address'to' parameter: Receiver's email address
400Invalid request content type. Expecting ‘multipart/form-data’ but got ‘application/x-www-form-urlencoded’The content type of the request is not what is expectedChange the request content type to 'multipart/form-data''multipart/form-data': A type of HTTP request commonly used for file uploads
400malformed multipart/form-data requestThe 'multipart/form-data' request is formatted incorrectlyCorrect the format of the 'multipart/form-data' request'multipart/form-data': A type of HTTP request commonly used for file uploads
400unable to parse request: invalid URL escapeThe URL in the request contains invalid escape charactersCorrect the escape characters in the URLURL escape characters: Characters used in a URL to represent certain other characters
400unable to parse request: unexpected EOFThe request ends unexpectedlyCheck the request for missing information or incorrect formattingEOF: End of File, in this case referring to the end of the request
400<time> invalid 24 hour time(value of ‘o:time-zone-localize’)The time provided is not in a valid 24-hour formatEnsure the time is in a valid 24-hour format'o:time-zone-localize': A parameter for setting the time zone
400<time> is not a valid time to send (value of ‘o:time-zone-localize’)The specified time is not a valid time to send the emailChoose a different, valid time to send the email'o:time-zone-localize': A parameter for setting the time zone
400invalid delivery time formatThe format of the delivery time is invalidCorrect the format of the delivery timeDelivery time: The time when the email should be delivered
400to parameter is not a valid address. please check documentationThe receiver's email address is invalidCheck and correct the format of the receiver's email address'to' parameter: Receiver's email address
400from parameter is not a valid address. please check documentationThe sender's email address is invalidCheck and correct the format of the sender's email address'from' parameter: Sender's email address
400cc parameter is not a valid address. please check documentationThe CC email address is invalidCheck and correct the format of the CC email address'cc' parameter: Carbon copy email address
400bcc parameter is not a valid address. please check documentationThe BCC email address is invalidCheck and correct the format of the BCC email address'bcc' parameter: Blind carbon copy email address
400‘recipient-variables’ parameter is not a valid JSONThe 'recipient-variables' parameter is not correctly formatted as JSONCorrect the format of the 'recipient-variables' parameter'recipient-variables' parameter: Variables specific to each recipient of the email
400Domain example.com is not allowed to send: Sandbox subdomains are for test purposes only. Please add your own domain or add the address to authorized recipients in Account Settings.The sender's domain is a sandbox subdomain, which are for testing onlyUse a non-sandbox domain, or add the recipient to the list of authorized recipientsSandbox domain: A domain for testing purposes
400Domain example.com is not allowed to send: Free accounts are for test purposes only. Please upgrade or add the address to authorized recipients in Account Settings.The sender's account is a free account, which is for testing onlyUpgrade to a paid account, or add the recipient to the list of authorized recipientsFree account: An account that doesn't require payment
400Domain example.com is not allowed to send: The domain is unverified and requires DNS configuration. Log in to your control panel to view required DNS records.The sender's domain is unverified and needs DNS configurationVerify the domain and configure the DNS as neededDNS: Domain Name System, a system for translating domain names to IP addresses
400Domain example.com is not allowed to send: Please activate your Mailgun account. Check your inbox or log in to your control panel to resend the activation email.The sender's Mailgun account is not activatedActivate the Mailgun account by following the instructions in the activation emailMailgun: A service for sending, receiving and tracking emails
400is not a valid secondary dkim domain nameThe provided secondary DKIM domain name is invalidCheck and correct the format of the secondary DKIM domain nameDKIM: DomainKeys Identified Mail, a method for verifying the authenticity of email senders
401ForbiddenThe user does not have the necessary permissions for the requestEnsure the user has the correct permissions for the requestForbidden: A status code indicating the user doesn't have necessary permissions
404Domain not found: example.comThe specified domain does not existUse a valid, existing domainDomain: The part of an email address after the @ symbol
403Domain example is not allowed to send large batches yetThe specified domain is not authorized to send large batches of emailsRequest permission to send large batches, or send smaller batchesBatch: A group of emails sent as part of a single operation
403Rejected: IP <id-address> can’t be used to send the messageThe IP address of the sender is not allowed to send the messageUse a different, authorized IP address to send the messageIP address: A unique identifier for devices on a network
413request size exceeds 52.4MiB limitThe size of the request exceeds the limit of 52.4MiBReduce the size of the request to under 52.4MiBMiB: Mebibyte, a unit of digital storage
429Domain example.com is not allowed to send: request limit exceeded, try again after Mon, 20 Dec 2021 20:33:21 UTCThe sender's domain has exceeded the limit for sending requestsWait until the specified time, then try sending the request againRequest limit: The maximum number of requests that can be sent in a given time period
429Domain example.com is not allowed to send: bytes limit exceeded, try again after Mon, 20 Dec 2021 20:33:21 UTCThe sender's domain has exceeded the limit for sending bytesWait until the specified time, then try sending the request againBytes limit: The maximum amount of data that can be sent in a given time period
429Domain example.com is not allowed to send: recipient limit exceeded, try again after Mon, 20 Dec 2021 20:33:21 UTCThe sender's domain has exceeded the limit for number of recipientsWait until the specified time, then try sending the request againRecipient limit: The maximum number of recipients that can be addressed in a given time period
500Internal Server ErrorThere is a problem with the serverWait and try the request again later, or contact the server administratorInternal Server Error: A general-purpose status code indicating a problem with the server