Error responses and what they mean
There is already an address book with that name in the account. Please make sure that the name of the address
book you are using is unique and not one of the reserved address book names such as Test or All Contacts.
The address book that you are attempting to create has some invalid properties. Please check the settings you
are using for this address book.
Your account will have a limited number of address books, which depends on the dotMailer edition you are using.
You have currently exceeded this limit. Please delete some of your unused address books.
The address book you have specified with the addressBookId argument does not relate to an address book which
exists in the dotMailer account you are currently connected to.
The address book you have specified with the addressBookId argument relates to an address book which cannot be
written to. For example, you cannot upload contacts to the Test address book via the API.
The last method call you made exceeded the cutoff of 15,000 API calls in a 24 hour window. You will be unable
to make any further API calls until the number of API calls made in the last 24 hours goes below this figure.
Please review your code to determine what is causing this excess usage.
The campaign that you are attempting to create has some invalid properties. Please check the settings you are
using for this campaign object.
The campaign you are trying to get could not be found within the dotMailer account. It is likely that you are
using the incorrect ID number.
The campaign you are trying to update cannot be updated, please check that you have the right ID.
We cannot permit you to send this campaign. This may be because you have not yet verified your account by
SMS, or because you have insufficient credit to send.
The contact you are trying to add is not valid. This means that there is something incorrect with the
contact object you are sending to the method. Check that your contact object is valid.
The ID of the contact you have selected is not present within the dotMailer account.
The contact you are trying to add to the address book has been suppressed. This means that you cannot add the contact
back into the address book or the account.
The contact you are trying to add has been suppressed for that address book, but not for the account. This means
that you cannot add the contact back into the address book, but you may add them to other address books in the same
You have exceeded the number of contacts permitted for your account type. Please consider upgrading your account.
You currently have more than the allowed data fields in your account, despite the fact that we advertise unlimited
data fields per account for some account levels. Please delete some of your unused datafields in order to create more.
One or more of the data fields you are trying to set for the contact does not exist. Please make sure that you create any
required data fields before attempting to assign values to them.
The datafield you are trying to add is not valid. This means that there is something incorrect with the datafield object
you are sending to the method.
The parent folder being listed, or that a document or folder is attempted to be created in, does not exist.
No document has been supplied when trying to upload a document.
The name of a document or folder being created or modified is blank or invalid.
No document could be found with the ID supplied.
No document folder could be found with the ID supplied.
The document attempting to be uploaded is too large.
The campaign that a document is attempting to be attached already has the maximum number of supported attachments.
The document attempting to be uploaded is an incorrect or unsupported file type.
The feature you are trying to access is not enabled for this account.
The parent folder that an image or folder is attempted to be created in does not exist.
The parent folder that an image or folder is attempted to be created in has been deleted.
The name of an image or folder being created is blank or invalid.
The image being uploaded is an incorrect file type (i.e. not an image).
No image has been supplied when trying to upload an image.
The GUID you have provided does not relate to an import in our system. Please check that you are entering the correct GUID.
You currently have more than 4 imports running in one go.
The email address of the contact you are adding is invalid. Each contact object must contain a valid email address.
The username or password you are attempting to authenticate your method call with is invalid. Please make sure you
have used the correct details. If your login attempt is still unsuccessful please follow the steps to reset your
username and password here. This error is also returned if the account you are attempting to connect to is turned
off or disabled.
The data file you are attempting to import does not contain an Email column. This column is required when importing
a file of data.
The datafield you are trying to create already exists within the dotMailer account you are connected to. Please
either use the existing datafield or choose a different name.
The email address that you are trying to use is not unique.
One of the method arguments you are sending is invalid.
You have exceeded the amount of sends your dotMailer account is allowed this month. Please contact your
account manager if you wish to send more.
The phone number you have attempted to send to is invalid.
You do not have sufficient credit within your dotMailer account for this SMS send. Please contact your account
manager if you need more sending credits.
The API is temporarily down most likely for scheduled maintenance, you should have received notification of this;
if you did not please subscribe to are user warning list here to be notified of these updates in future.
The template that you are attempting to create has some invalid properties. Please check the settings you are
using for this template object.
The template you are trying to get could not be found within the dotMailer account. It is likely that you are
using the incorrect ID number.
We do not know what went wrong. Please contact our support department if you require assistance.