Loading...

Knowledge Base

Add a Mailing List for Business and Enterprise Email Using the API

When you want to add a mailing list for Business or Enterprise Email using the API. This article explains mailing list parameters, posting permissions, moderation settings, and API request details for mailing list creation.

Add Mailing List

Description

Adds a new mailing list.

Parameters

NameData TypeRequired / OptionalDescription
auth-useridIntegerRequiredAuthentication Parameter
api-keyStringRequiredAuthentication Parameter
order-idIntegerRequiredOrder ID of the Domain Registration, Email Hosting, Legacy Web Hosting, Website Builder, Enterprise Email Order
list-addressStringRequiredAn email address representing mailing-list
subscription-heldBooleanRequiredValues can be: true or false.
who-can-postStringRequiredValues can be: anyone, only_members or only_moderators.
send-messages-for-moderationBooleanRequiredValues can be: true or false.
reply-toStringRequiredValues can be: sender, entire_list or custom_address.
moderatorsStringRequiredA CSV of email addresses
custom-emailStringOptionalAn email address, required in case reply_to=custom_address
footer-textStringOptionalText value for the footer

HTTP Method

POST

Example Test URL Request

https://test.httpapi.com/api/mail/mailinglist/add.json?auth-userid=0&api-key=key&order-id=0&list-address=list-name@domainname.com&subscription-held=false&who-can-post=only_members&send-messages-for-moderation=false&reply-to=sender&moderators=user1@domainname.com,user2@domainname.com

Response

Returns "SUCCESS" as the status if a mailing list is added successfully.