mask

Application Programming Interface

Welcome to the JangoMail API, a web service which allows you to programmatically control your JangoMail account using an HTTP GET, POST or an XML-based SOAP call. Below are some resources to help you get started using the JangoMail API.

Technical Documentation

All API methods are categorized below. Expand a section to view the methods within, then select a method to view detailed parameter information, sample calls and form to try out the method.

[expand all] [collapse all]

List Management

Campaign Sending

Campaign Reporting

Transactional Sending

Transactional Reporting

Account Management

Unsubscribe Management

Bounce Management

Exceptions

AssetNotFoundException The specified file name does not exist.
AttachmentExceptionXXXX
BouncedEmailAddressException Email address is on account's Bounce List. This means it has bounced at least one time in the past and is likely an invalid address.
CannotSendExceptionThis account cannot currently send emails as the sending limit has been exceeded. Please upgrade the account to continue sending.
DefaultGroupNameException The default transactional group cannot be renamed or deleted and a new group cannot be named "Default Transactional Group".
DuplicateEmailAddressExceptionEmail address already in List. List does not allow duplicate email addresses.
DuplicateGroupFieldException List field already exists.
DuplicateGroupNameException List name already exists.
DuplicateIPAddressExceptionThe specified IP Address is already registered.
DuplicateMassEmailException A campaign with this subject and list was recently sent.
DuplicateUsernameExceptionThe supplied Username is already in use.
InvalidAgencyAccountException The specified Master Agency Account could not be found.
InvalidBCCEmailException Invalid BCC email.
InvalidCCEmailException Invalid CC email.
InvalidCharacterSetException Invalid Character Set.
InvalidDateException Date specified is invalid.
InvalidEmailAddressException Email address is invalid.
InvalidEncodingException Invalid Encoding.
InvalidFieldCountException Invalid field count.
InvalidFieldNameException Invalid field name.
InvalidFileSizeException Specified file is empty.
InvalidFromEmailException Invalid From email.
InvalidGroupFieldsException The list of fields must include the EmailAddress field.
InvalidGroupFilterException Invalid list filter specification.
InvalidGroupIDException Invalid Group ID.
InvalidGroupListException Invalid list name.
InvalidGroupNameException List name is invalid.
InvalidIPAddressException The specified value does not exist or is not a valid IP Address.
InvalidJobIDExceptionThe given Job ID does not exist.
InvalidListException List XXXX is invalid.
InvalidMassEmailIDException Invalid campaign ID.
InvalidMessageIsPlainException If MessageType=Plain then MessagePlain must be blank.
InvalidMessageTypeException Invalid Message Type. Acceptable types are Plain and HTML.
InvalidOptionException Invalid Option specified.
InvalidPriorityException Invalid Priority.
InvalidReplyEmailException Invalid Reply-To email.
InvalidSecretTokenExceptionInvalid Secret Token
InvalidTimeZoneNameExceptionAn invalid timezone name was specified. Valid timezones are: Dateline Standard Time, UTC-11, Aleutian Standard Time, Hawaiian Standard Time, Marquesas Standard Time, Alaskan Standard Time, UTC-09, Pacific Standard Time (Mexico), UTC-08, Pacific Standard Time, US Mountain Standard Time, Mountain Standard Time (Mexico), Mountain Standard Time, Yukon Standard Time, Central America Standard Time, Central Standard Time, Easter Island Standard Time, Central Standard Time (Mexico), Canada Central Standard Time, SA Pacific Standard Time, Eastern Standard Time (Mexico), Eastern Standard Time, Haiti Standard Time, Cuba Standard Time, US Eastern Standard Time, Turks And Caicos Standard Time, Atlantic Standard Time, Venezuela Standard Time, Central Brazilian Standard Time, SA Western Standard Time, Pacific SA Standard Time, Newfoundland Standard Time, Tocantins Standard Time, Paraguay Standard Time, E. South America Standard Time, SA Eastern Standard Time, Argentina Standard Time, Montevideo Standard Time, Magallanes Standard Time, Saint Pierre Standard Time, Bahia Standard Time, UTC-02, Greenland Standard Time, Mid-Atlantic Standard Time, Azores Standard Time, Cape Verde Standard Time, UTC, GMT Standard Time, Greenwich Standard Time, Sao Tome Standard Time, Morocco Standard Time, W. Europe Standard Time, Central Europe Standard Time, Romance Standard Time, Central European Standard Time, W. Central Africa Standard Time, GTB Standard Time, Middle East Standard Time, Egypt Standard Time, E. Europe Standard Time, West Bank Standard Time, South Africa Standard Time, FLE Standard Time, Israel Standard Time, South Sudan Standard Time, Kaliningrad Standard Time, Sudan Standard Time, Libya Standard Time, Namibia Standard Time, Jordan Standard Time, Arabic Standard Time, Syria Standard Time, Turkey Standard Time, Arab Standard Time, Belarus Standard Time, Russian Standard Time, E. Africa Standard Time, Volgograd Standard Time, Iran Standard Time, Arabian Standard Time, Astrakhan Standard Time, Azerbaijan Standard Time, Russia Time Zone 3, Mauritius Standard Time, Saratov Standard Time, Georgian Standard Time, Caucasus Standard Time, Afghanistan Standard Time, West Asia Standard Time, Qyzylorda Standard Time, Ekaterinburg Standard Time, Pakistan Standard Time, India Standard Time, Sri Lanka Standard Time, Nepal Standard Time, Central Asia Standard Time, Bangladesh Standard Time, Omsk Standard Time, Myanmar Standard Time, SE Asia Standard Time, Altai Standard Time, W. Mongolia Standard Time, North Asia Standard Time, N. Central Asia Standard Time, Tomsk Standard Time, China Standard Time, North Asia East Standard Time, Singapore Standard Time, W. Australia Standard Time, Taipei Standard Time, Ulaanbaatar Standard Time, Aus Central W. Standard Time, Transbaikal Standard Time, Tokyo Standard Time, North Korea Standard Time, Korea Standard Time, Yakutsk Standard Time, Cen. Australia Standard Time, AUS Central Standard Time, E. Australia Standard Time, AUS Eastern Standard Time, West Pacific Standard Time, Tasmania Standard Time, Vladivostok Standard Time, Lord Howe Standard Time, Bougainville Standard Time, Russia Time Zone 10, Magadan Standard Time, Norfolk Standard Time, Sakhalin Standard Time, Central Pacific Standard Time, Russia Time Zone 11, New Zealand Standard Time, UTC+12, Fiji Standard Time, Kamchatka Standard Time, Chatham Islands Standard Time, UTC+13, Tonga Standard Time, Samoa Standard Time, Line Islands Standard Time
InvalidTransactionalGroupIDException Invalid Transactional Group ID.
InvalidTransactionalIDException Invalid Transactional ID.
InvalidTriggerListException Invalid trigger list.
InvalidUsernameExceptionInvalid Username.
LoggingException An unknown logging exception was encountered.
LoginFailedException Username and password do not match.
MessageSizeExceededException XXXX
MissingRequiredParameterExceptionA required field was not supplied: XXXX.
MissingRequiredParameterFromDisplayNameException The From Display Name is a required parameter and is missing.
MissingRequiredParameterSubjectException The Subject is a required parameter and is missing.
MissingWebDatabaseSettingsThere is no Master Web Database Connection Profile set for your account. This must be set prior to specifying a SQL query for the ToWebDatabase parameter.
NoAddressesSpecifiedException No Addresses Specified. Use either To or ToManual Fields.
NoMessageException MessagePlain and/or MessageHTML must be specified.
NoRecipientsException No recipients specified for this campaign.
OverEmailLimitException This email cannot be sent because your account is at its allowed limits. Visit http://www.jangomail.com/Support or http://www.jangomail911.com if you need an emergency upgrade.
PaidAccountsOnlyException This method is not available to free trial accounts.
SystemDomainAddressException Email address domain is on the Global Domain Suppression List.
SystemEmailAddressException Email address is on the Global Suppression List.
ToConflictException You may only specify one of ToOther or ToWebdatabase or ToGroupFilter.
TooManyRecordsException Date range resulted in too many records. Please narrow date range to pull 20,000 records or less.
UnauthorizedAddressException The current IP Address (216.73.216.37) is not authorized to access the API.
UnknownException An unknown exception was encountered.
UnsubscribedEmailAddressException Email address is on account's Unsubscribe List.
UserDomainAddressException Email address domain is on account's Unsubscribe List.

DomainKeys Management

Block Management

© Copyright 2000-2026 JangoMail, Inc. All Rights Reserved.1-888-GO-JANGO (1-888-465-2646 [USA]) • Privacy Policy