Available XMLRPC methods for this server

Index

Details

(boolean) campaignUnschedule((string) uid, (string) cid)

Description :

Unschedule a campaign that is scheduled to be sent in the future

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the id for the campaign to unschedule

(return to index)

(boolean) campaignSchedule((string) uid, (string) cid, (string) schedule_time)

Description :

Schedule a campaign to be sent in the future

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the id for the campaign to schedule
stringschedule_time the time to schedule the campaign - in YYYY-MM-DD HH:II:SS format in GMT

(return to index)

(boolean) campaignSendNow((string) uid, (string) cid)

Description :

Send a given campaign immediately

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the id for the campaign to send

(return to index)

(boolean) campaignSendTest((string) uid, (string) cid [ , (array) test_emails, (string) send_type ] )

Description :

Send a test of this campaign to the provided email address

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the id for the campaign to test
arraytest_emails an array of email address to receive the test message
stringsend_type optional default (null) sends both, "html" or "text" send just that format

(return to index)

(array) campaignTemplates((string) uid)

Description :

Retrieve all templates defined for your user account

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)

(return to index)

(string) campaignCreate((string) uid, (string) list_id, (string) subject, (string) from_email, (string) from_name, (array) content [ , (integer) template_id, (array) tracking, (string) title, (boolean) authenticate, (string) analytics ] )

Description :

Create a new draft campaign to send

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringlist_id the list to send this campaign to- get lists using getLists()
stringsubject the subject line for your campaign message
stringfrom_email the From: email address for your campaign message
stringfrom_name the From: name for your campaign message
arraycontent the content for this campaign - use a struct with the following keys: "html" for pasted HTML content and "text" for the plain-text version. If you chose a template instead of pasting in your HTML content, then use "html_" followed by the template sections as keys - for example, use a key of "html_MAIN" to fill in the "MAIN" section of a template. Supported template sections include: "html_HEADER", "html_MAIN", "html_SIDECOLUMN", and "html_FOOTER"
integertemplate_id optional - use this template to generate the HTML content of the campaign
arraytracking optional - set which recipient actions will be tracked, as a struct of boolean values with the following keys: "opens", "html_clicks", and "text_clicks". By default, opens and HTML clicks will be tracked.
stringtitle optional - an internal name to use for this campaign. By default, the campaign subject will be used.
booleanauthenticate optional - set to true to enable SenderID, DomainKeys, and DKIM authentication, defaults to false
stringanalytics optional - if provided, use a struct with "service type" as a key and the "service tag" as a value. For Google, this should be "google"=>"your_google_analytics_key_here". Note that only "google" is currently supported - a Google Analytics tags will be added to all links in the campaign with this string attached. Others may be added in the future

(return to index)

(string) campaigns((string) uid [ , (string) filter_id, (integer) filter_folder, (string) filter_fromname, (string) filter_fromemail, (string) filter_title, (string) filter_subject, (string) filter_sendtimestart, (string) filter_sendtimeend, (boolean) filter_exact, (integer) start, (integer) limit ] )

Description :

Get the list of campaigns and associated information for a list

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringfilter_id optional - only show campaigns from this list id - get lists using getLists()
integerfilter_folder optional - only show campaigns from this folder id - get folders using campaignFolders()
stringfilter_fromname optional - only show campaigns that have this "From Name"
stringfilter_fromemail optional - only show campaigns that have this "Reply-to Email"
stringfilter_title optional - only show campaigns that have this title
stringfilter_subject optional - only show campaigns that have this subject
stringfilter_sendtimestart optional - only show campaigns that have been sent since this date/time
stringfilter_sendtimeend optional - only show campaigns that have been sent before this date/time
booleanfilter_exact optional - flag for whether to filter on exact values when filtering, or search within content for filter values
integerstart optional - control paging of campaigns, start results at this campaign #, defaults to 1st page of data (page 0)
integerlimit optional - control paging of campaigns, number of campaigns to return with each call, defaults to 25 (max=5000)

(return to index)

(string) campaignFolders((string) uid)

Description :

List all the folders for a user account

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)

(return to index)

(integer) campaignStats((string) uid, (string) cid)

Description :

Given a list and a campaign, get all the relevant campaign statistics (opens, bounces, clicks, etc.)

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the campaign id to pull stats for (can be gathered using campaigns($id))

(return to index)

(integer) campaignClickStats((string) uid, (string) cid)

Description :

Get an array of the urls being tracked, and their click counts for a given campaign

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the campaign id to pull stats for (can be gathered using campaigns($id))

(return to index)

(array) campaignBounces((string) uid, (string) cid)

Description :

Get all bounced email addresses for a given campaign<br/>
<strong>DEPRECATED:</strong> campaignBounces() has been deprecated and will be removed completely in a future release. see campaignHardBounces() and campaignSoftBounces() for replacements.

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the campaign id to pull bounces for (can be gathered using campaigns($id))

(return to index)

(array) campaignHardBounces((string) uid, (string) cid [ , (integer) start, (integer) limit ] )

Description :

Get all email addresses with Hard Bounces for a given campaign

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the campaign id to pull bounces for (can be gathered using campaigns($id))
integerstartart optional, for large data sets, the page number to start at - defaults to 1st page of data (page 0)
integerlimitmit optional, for large data sets, the number of results to return - defaults to 1000, upper limit set at 15000

(return to index)

(array) campaignSoftBounces((string) uid, (string) cid [ , (integer) start, (integer) limit ] )

Description :

Get all email addresses with Soft Bounces for a given campaign

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the campaign id to pull bounces for (can be gathered using campaigns($id))
integerstartart optional, for large data sets, the page number to start at - defaults to 1st page of data (page 0)
integerlimitmit optional, for large data sets, the number of results to return - defaults to 1000, upper limit set at 15000

(return to index)

(array) campaignUnsubscribes((string) uid, (string) cid [ , (integer) start, (integer) limit ] )

Description :

Get all unsubscribed email addresses for a given campaign

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the campaign id to pull bounces for (can be gathered using campaigns($id))
integerstartart optional, for large data sets, the page number to start at - defaults to 1st page of data (page 0)
integerlimitmit optional, for large data sets, the number of results to return - defaults to 1000, upper limit set at 15000

(return to index)

(array) campaignAbuseReports((string) uid, (string) cid [ , (integer) start, (integer) limit ] )

Description :

Get all email addresses that complained about a given campaign

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the campaign id to pull bounces for (can be gathered using campaigns($id))
integerstartart optional, for large data sets, the page number to start at - defaults to 1st page of data (page 0)
integerlimitmit optional, for large data sets, the number of results to return - defaults to 1000, upper limit set at 15000

(return to index)

(string) campaignContent((string) uid, (string) cid)

Description :

Get the content (both html and text) for a campaign, exactly as it would appear in the campaign archive

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the campaign id to get content for (can be gathered using campaigns($id))

(return to index)

(integer) campaignOpenedAIM((string) uid, (string) cid [ , (integer) start, (integer) limit ] )

Description :

Retrieve the list of email addresses that opened a given campaign with how many times they opened

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the campaign id to get opens for (can be gathered using campaigns($id))
integerstartart optional, for large data sets, the page number to start at - defaults to 1st page of data (page 0)
integerlimitmit optional, for large data sets, the number of results to return - defaults to 1000, upper limit set at 15000

(return to index)

(array) campaignNotOpenedAIM((string) uid, (string) cid [ , (integer) start, (integer) limit ] )

Description :

Retrieve the list of email addresses that did not open a given campaign

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the campaign id to get no opens for (can be gathered using campaigns($id))
integerstartart optional, for large data sets, the page number to start at - defaults to 1st page of data (page 0)
integerlimitmit optional, for large data sets, the number of results to return - defaults to 1000, upper limit set at 15000

(return to index)

(integer) campaignClickDetailAIM((string) uid, (string) cid, (string) url [ , (integer) start, (integer) limit ] )

Description :

Return the list of email addresses that clicked on a given url, and how many times they clicked

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the campaign id to get click stats for (can be gathered using campaigns($id))
stringurl the URL of the link that was clicked on
integerstartart optional, for large data sets, the page number to start at - defaults to 1st page of data (page 0)
integerlimitmit optional, for large data sets, the number of results to return - defaults to 1000, upper limit set at 15000

(return to index)

(string) campaignEmailStatsAIM((string) uid, (string) cid, (string) email_address)

Description :

Given a campaign and email address, return the entire click and open history with timestamps, ordered by time

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringcid the campaign id to get stats for (can be gathered using campaigns($id))
stringemail_address the email address to get activity history for

(return to index)

(integer) lists((string) uid)

Description :

Retrieve all of the lists defined for your user account

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)

(return to index)

(string) listMergeVars((string) uid, (string) id)

Description :

Get the list of merge tags for a given list, including their name, tag, and required setting

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringid the list id to connect to

(return to index)

(array) listInterestGroups((string) uid, (string) id)

Description :

Get the list of interest groups for a given list, including the label and form information

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringid the list id to connect to

(return to index)

(boolean) listSubscribe((string) uid, (string) id, (string) email_address, (array) merge_vars [ , (string) email_type, (boolean) double_optin ] )

Description :

Subscribe the provided email to a list

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringid the list id to connect to
stringemail_address the email address to subscribe
arraymerge_vars array of merges for the email (FNAME, LNAME, etc.) (see examples below for handling "blank" arrays). Set Interest Groups by passing a field named "INTERESTS" that contains a comma delimited list of Interest Groups to add.
stringemail_type optional - email type preference for the email (html or text, defaults to html)
booleandouble_optin optional - flag to control whether a double opt-in confirmation message is sent, defaults to true

(return to index)

(boolean) listUnsubscribe((string) uid, (string) id, (string) email_address [ , (boolean) delete_member, (boolean) send_goodbye, (boolean) send_notify ] )

Description :

Unsubscribe the given email address from the list

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringid the list id to connect to
stringemail_address the email address to unsubscribe
booleandelete_member flag to completely delete the member from your list instead of just unsubscribing, default to false
booleansend_goodbye flag to send the goodbye email to the email address, defaults to true
booleansend_notify flag to send the unsubscribe notification email to the address defined in the list email notification settings, defaults to true

(return to index)

(boolean) listUpdateMember((string) uid, (string) id, (string) email_address, (array) merge_vars [ , (string) email_type, (boolean) replace_interests ] )

Description :

Edit the email address, merge fields, and interest groups for a list member

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringid the list id to connect to
stringemail_address the current email address of the member to update
arraymerge_vars array of new field values to update the member with. Use "EMAIL" to update the email address and "INTERESTS" to update the interest groups
stringemail_type change the email type preference for the member ("html" or "text"). Leave blank to keep the existing preference (optional)
booleanreplace_interests flag to determine whether we replace the interest groups with the updated groups provided, or we add the provided groups to the member's interest groups (optional, defaults to true)

(return to index)

(array) listBatchSubscribe((string) uid, (string) id, (array) batch [ , (boolean) double_optin, (boolean) update_existing, (boolean) replace_interests ] )

Description :

Subscribe a batch of email addresses to a list at once

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringid the list id to connect to
arraybatch an array of structs for each address to import with two special keys: "EMAIL" for the email address, and "EMAIL_TYPE" for the email type option (html or text)
booleandouble_optin flag to control whether to send an opt-in confirmation email - defaults to true
booleanupdate_existing flag to control whether to update members that are already subscribed to the list or to return an error, defaults to false (return error)
booleanreplace_interests flag to determine whether we replace the interest groups with the updated groups provided, or we add the provided groups to the member's interest groups (optional, defaults to true)

(return to index)

(array) listBatchUnsubscribe((string) uid, (string) id, (array) emails [ , (boolean) delete_member, (boolean) send_goodbye, (boolean) send_notify ] )

Description :

Unsubscribe a batch of email addresses to a list

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringid the list id to connect to
arrayemails array of email addresses to unsubscribe
booleandelete_member flag to completely delete the member from your list instead of just unsubscribing, default to false
booleansend_goodbye flag to send the goodbye email to the email addresses, defaults to true
booleansend_notify flag to send the unsubscribe notification email to the address defined in the list email notification settings, defaults to false

(return to index)

(date) listMembers((string) uid, (string) id [ , (string) status, (integer) start, (integer) limit ] )

Description :

Get all of the list members of a list that are of a particular status

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringid the list id to connect to
stringstatus the status to get members for - one of(subscribed, unsubscribed, or cleaned), defaults to subscribed
integerstartart optional, for large data sets, the page number to start at - defaults to 1st page of data (page 0)
integerlimitmit optional, for large data sets, the number of results to return - defaults to 100, upper limit set at 15000

(return to index)

(date) listMemberInfo((string) uid, (string) id, (string) email_address)

Description :

Get all the information for a particular member of a list

Parameters :

TypeNameDocumentation
stringuid the id for your user account. Get by calling login($user, $pass)
stringid the list id to connect to
stringemail_address the member email address to get information for

(return to index)

(boolean) closeOneOhSecurityHole((string) username, (string) password)

Description :

Disable a pretty bad security hole that exists in our 1.0 version of the API. If you have never used
the API, we close this hole for you automatically. If you are an existing user, even if you upgraded to
version 1.1, you should run this once anyways. Running this will *not* prevent you from using version 1.0 if you need to.

Parameters :

TypeNameDocumentation
stringusername Your MailChimp user name
stringpassword Your MailChimp password

(return to index)

(string) login((string) username, (string) password)

Description :

Log into the MailChimp API - see closeOneOhSecurityHole() !!!!

Parameters :

TypeNameDocumentation
stringusername Your MailChimp user name
stringpassword Your MailChimp password

(return to index)

(mixed) callMethod()

Description :

Internal function - proxy method for certain XML-RPC calls | DO NOT CALL

(return to index)