Skip to content

Latest commit

 

History

History
720 lines (625 loc) · 31.5 KB

README.md

File metadata and controls

720 lines (625 loc) · 31.5 KB
Raw

Maropost API PHP Package

Summary

This package provides programmatic access to several Maropost services. It consists of eight services within the Maropost.Api namespace. Each service consists of one or more functions that perform an operation against your Maropost account. These functions return a result object indicating success/failure, any Exceptions throw, and the resulting data.

Installation

Composer

Composer is a modern alternative to PEAR and easy to work with. Because this package is PSR-4-compliant, you can install it using Composer. To do so, simply add maropost/api to the "require" object in your own project's composer.json file.

{
    "require": {
        "maropost/api": "*"
    }
}

Install from Source

You can also just clone the API repository and use a PSR-4-compatible autoloader to load the library. Our testing file at ~/tests/index.php gives one example of how to do this. You will need to view our composer.json file for the dependencies (listed under "requires") and make sure you have them installed.

Usage

To use a service, first instantiate it, providing your Maropost AccountId and Auth Token. For example, to get your list of reports using the Reports service, execute:

$reports = new Maropost.Api.Reports($myAccountId, $myAuthToken);
$result = $reports.get();
if ($result.isSuccess) {
    $myReports = $result.getData();
}

The result object contains three fields:

  • isSuccess (boolean)
  • errorMessage (string)
  • exception (Exception)

If isSuccess is false, then errorMessage will contain information, and exception might contain an exception, depending upon the reason for failure. If exception is not null, then isSuccess will always be false.

The object also contains one function, getData(), which contains whatever data the operation itself provides. Some operations, such as delete() operations, might not provide any data.

Specific APIs

The specific APIs contained are:

Campaigns

Instantiation:

new Maropost.Api.Campaigns($myAccountId, $myAuthToken)

Available methods:

  • get(int $page)
    • returns the list of campaigns for the account
    • $page: page # (>= 1). Up to 200 records returned per page.
  • getCampaign(int $campaignId)
    • returns the given campaign
    • $campaignId
  • getBounceReports(int $id, int $page)
    • returns the list of bounce reports for the given campaign ID
    • $page: page # (>= 1). Up to 200 records returned per page.
  • getClickReports(int $id, int $page, bool unique = null)
    • returns the list of click reports for the given campaign ID
    • $page: page # (>= 1). Up to 200 records returned per page.
    • $unique: true = get for unique contacts. Otherwise, false.
  • getComplaintReports(int $id, int $page)
    • returns the list of complaint reports for the given campaign ID
    • $page: page # (>= 1). Up to 200 records returned per page.
  • getDeliveredReports(int $id, int $page)
    • returns the list of delivered reports for the given campaign ID
    • $page: page # (>= 1). Up to 200 records returned per page.
  • getHardBounceReports(int $id, int $page)
    • returns the list of hard bounces for the given campaign ID
    • $page: page # (>= 1). Up to 200 records returned per page.
  • getLinkReports(int $id, int $page, bool unique = null)
    • returns the list of link reports for the given campaign ID
    • $page: page # (>= 1). Up to 200 records returned per page.
    • $unique: true = get for unique contacts. Otherwise, false.
  • getOpenReports(int $id, int $page, bool unique = null)
    • returns the list of open reports for the given campaign ID
    • $page: page # (>= 1). Up to 200 records returned per page.
    • $unique: true = get for unique contacts. Otherwise, false.
  • getSoftBounceReports(int $id, int $page)
    • returns the list of soft bounce reports for the given campaign ID
    • $page: page # (>= 1). Up to 200 records returned per page.
  • getUnsubscribeReports(int $id, int $page)
    • returns the list of unsubscribe reports for the given campaign ID
    • $page: page # (>= 1). Up to 200 records returned per page.

AB Test Campaigns

Instantiation:

new Maropost.Api.AbTestCampaigns($myAccountId, $myAuthToken)

Available Methods:

  • createAbTest(string $name, string $fromEmail, string $replyTo, string $address, string $language, array $campaignGroupsAttributes, string commit, \DateTime $sendAt, int $brandId = null, array $suppressedListIds = [], array $suppressedSegmentIds = [], array $suppressedJourneyIds = [], int $emailPreviewLink = null, string $decidedBy = null, array $lists = [], array $cTags = [], array $segments = [])
    • $name: name of the new campaign
    • $fromEmail: default sender email address for campaign emails
    • $replyTo: default reply-to email address for campaign emails
    • $address: default physical address included on campaign emails
    • $language: ISO 639-1 language code (e.g, "en"). 2 characters.
    • $campaignGroupsAttributes: array of attributes. Each attribute is itself an object with the following properties (all strings):
      • name: name of the group
      • content_id: content ID
      • subject: subject line of emails
      • from_name: "from name" on emails
      • percentage: percentage of emails that should be sent with these settings.
      • preheader:
      • send_at: string to represent DateTime, having the format YYYY-MM-DD HH:mm:ss
    • $commit: allowed values: 'Save as Draft' or 'Send Test' or 'Schedule'
    • $sendAt: DateTime object representing the start of the AB campaign
    • $brandId: brand ID as a string
    • $suppressedListIds: array of list IDs (in string format)
    • $suppressedSegmentIds: array of segment IDs (in string format)
    • $suppressedJourneyIds: array of journey IDs (in string format)
    • $emailPreviewLink: 1 (true) to email the preview link. 0 (false) otherwise.
    • $decidedBy: allowed values: ('TopChoice' for Top Choices) or ('Opens' for Highest Open Rate) or ('Clicks' for Highest Click Rate) or ('Manual' for Manual Selection) or ('click_to_open' for Highest Click-to-Open Rate) or ('conversions' for Highest Conversion Rate)
    • $lists: array of targeted list IDs (in string format)
    • $cTags: array of tags in string format
    • $segments: array of targeted segment IDs (in string format)

Transactional Campaigns

Instantiation:

new Maropost.Api.TransactionalCampaigns($myAccountId, $myAuthToken)

Available methods:

  • get(int $page)

    • returns the list of Transaction Campaigns
    • $page: page # (>= 1). Up to 200 records returned per page.

  • create(string $name, string $subject, string $preheader, string $fromName, string $fromEmail, string $replyTo, int $contentId, bool $emailPreviewLink, string $address, string $language, string... $ctags)

    • Creates a Transactional Campaign
    • $name campaign name
    • $subject campaign subject
    • $preheader campaign preheader
    • $fromName sender name in the email
    • $fromEmail sender email address
    • $replyTo reply-to email address
    • $contentId
    • $emailPreviewLink
    • $address physical address
    • $language ISO 639-1 language code
    • ...$ctags array of campaign tags

  • sendEmail(int $campaignId, int $contentId = null, string $contentName = null, string $contentHtmlPart = null, string $contentTextPart = null, int $sendAtHour = null, int $sendAtMinute = null, bool $ignoreDnm = null, int $contactId = null, string $recipientEmail = null, string $recipientFirstName = null, string $recipientLastName = null, array $recipientCustomFields = null, string $bccEmail = null, string $fromName = null, string $fromEmail = null, string $subject = null, string $replyTo = null, string $senderAddress = null, array $tags = null, array $ctags = null )

    • Sends a transactional campaign email to a recipient. Sender's information will be automatically fetched from the transactional campaign, unless provided in the function arguments.
    • $campaignId: must be a campaign that already exists when you call $svc->get(). If you don't have one, first call $svc->create().
    • $contentId: If provided, the transactional campaign's content will be replaced by this content.
    • $contentName: If $contentId is null, the transactional campaign's content name will be replaced by this name.
    • $contentHtmlPart: If $contentId is null, the transactional campaign's content HTML part will be replaced by this HTML part.
    • $contentTextPart: If $contentId is null, the transactional campaign's content Text part will be replaced by this Text part.
    • $sendAtHour: Must be 1-12. Otherwise the email will go out immediately. If the hour is less than the current hour, the email will go out the following day.
    • $sendAtMinute: Must be 0-60. Otherwise will be treated as 0. If the hour and minute combine to less than the current time, the email will go out the following day.
    • $ignoreDnm: If true, ignores the Do Not Mail list for the recipient contact.
    • $contactId: contact ID of the recipient.
    • $recipientEmail: email address. Ignored unless $contactId is null. Otherwise, it must be a well-formed email address according to FILTER_VALIDATE_EMAIL.
    • $recipientFirstName: recipient's first name. Ignored unless $contactId is null.
    • $recipientLastName: recipient's last name. Ignored unless $contactId is null.
    • $recipientCustomFields: custom fields for the recipient. Ignored unless $contactId is null. Is an associative array where the item key is the name of the custom field, and the item value is the field value. All keys must be strings. All values must be non-null scalars.
    • $bccEmail: BCC recipient. May only pass a single email address, empty string, or null. If provided, it must be a well-formed email address according to FILTER_VALIDATE_EMAIL.
    • $fromName: sender's name. If $fromEmail is set, it overrides the transactional campaign default sender name. Ignored otherwise.
    • $fromEmail: sender's email address. Overrides the transactional campaign default sender email.
    • $subject: subject line of email. Overrides the transactional campaign default subject.
    • $replyTo: reply-to address. Overrides the transactional campaign default reply-to.
    • $senderAddress: physical address of sender. Overrides the transactional campaign default sender address.
    • $tags: associative array where the item key is the name of the tag within the content, and the item value is the tag's replacement upon sending. All keys must be strings. All values must be non-null scalars.
    • $ctags: campaign tags. Must be a simple array of scalar values.

Contacts

Instantiation:

new Maropost.Api.Contacts($myAccountId, $myAuthToken)

Available methods:

  • getForEmail(string $email)

    • Gets the contact according to email address
    • $email: email address of the contact

  • getOpens(int $contactId, int $page)

    • Gets the list of opens for the specified contact
    • $page: page # (>= 1). Up to 200 records returned per page.

  • getClicks(int $contactId, int $page)

    • Gets the list of clicks for the specified contact
    • $page: page # (>= 1). Up to 200 records returned per page.

  • getForList(int $listId, int $page)

    • Gets the list of contacts for the specified list
    • $page: page # (>= 1). Up to 200 records returned per page.

  • getContactForList(int $listId, int $contactId)

    • Gets the specified contact from the specified list
    • $listId
    • $contactId

  • public function updateForListAndContact( int $listId, int $contactId, string $email, string $firstName = null, string $lastName = null, string $phone = null, string $fax = null, string $uid = null, array $customField = [], array $addTags = [], array $removeTags = [], bool $removeFromDNM = true, bool $subscribe = true )

    • Creates a contact within a list. Updates if previous contact is matched by email
    • $listId: ID of the list to which the contact being updated belongs
    • $contactId: ID of the contact being updated
    • $email: Email address for the contact to be updated
    • $firstName: first name of Contact
    • $lastName: last name of Contact
    • $phone: phone number of Contact
    • $fax: fax number of Contact
    • $uid: UID for the Contact
    • $customField: custom fields passed as associative array. Keys represent the field names while values represent the values
    • $addTags: tags to add to the contact. Simple array of tag names
    • $removeTags: tags to remove from the contact. Simple array of tag names
    • $removeFromDNM: set this true to subscribe contact to the list, and remove it from DNM)
    • $subscribe: set this true to subscribe contact to the list; false otherwise

  • createOrUpdateForList( int $listId, string $email, string $firstName = null, string $lastName = null, string $phone = null, string $fax = null, string $uid = null, array $customField = [], array $addTags = [], array $removeTags = [], bool $removeFromDNM = true, bool $subscribe = true )

    • Creates a contact within a list. Updates if previous contact is matched by email.
    • $listId: ID of the list for which the contact is being created
    • $email: email address for the contact to be created|updated
    • $firstName: first name of Contact
    • $lastName: last Name of Contact
    • $phone: phone number of Contact
    • $fax: fax number of Contact
    • $uid: UID for the contact
    • $customField: custom fields passed as associative array. Keys represent the field names while values represent the values.
    • $addTags: tags to add to the contact. Simple array of tag names (strings).
    • $removeTags: tags to remove from the contact. Simple array of tag names (strings).
    • $removeFromDNM: Set this true to subscribe contact to the list, and remove it from DNM.
    • $subscribe: true to subscribe the contact to the list; false otherwise.

  • createOrUpdateContact( int $contactId, string $email, string $firstName = null, string $lastName = null, string $phone = null, string $fax = null, string $uid = null, array $customField = [], array $addTags = [], array $removeTags = [], bool $removeFromDNM = true, bool $subscribe = true )

    • Creates a contact without a list. Updates if already existing email is passed.
    • $contactId: ID of the contact
    • $email: Email address for the contact to be created|updated
    • $firstName: first name of Contact
    • $lastName: last Name of Contact
    • $phone: phone number of Contact
    • $fax: fax number of Contact
    • $uid: UID for the contact
    • $customField: custom fields passed as associative array. Keys represent the field names while values represent the values
    • $addTags: tags to add to the contact. Simple array of tag names (strings).
    • $removeTags: tags to remove from the contact. Simple array of tag names (strings).
    • $removeFromDNM: set this true to subscribe contact to the list, and remove it from DNM

  • createOrUpdateForListsAndWorkflows( string $email, string $firstName = null, string $lastName = null, string $phone = null, string $fax = null, string $uid = null, array $customField = [], array $addTags = [], array $removeTags = [], bool $removeFromDNM = false, array $subscribeListIds = [], array $unsubscribeListIds = [], array $unsubscribeWorkflowIds = [], string $unsubscribeCampaign = null )

    • Creates or updates Contact
      • Multiple lists can be subscribed, unsubscribed.
      • Multiple workflows can be unsubscribed.
    • $email: email address for the contact to be created|updated
    • $firstName: first name of Contact
    • $lastName: last name of Contact
    • $phone: phone number of Contact
    • $fax: fax number of Contact
    • $uid: UID for the Contact
    • $customField: custom fields passed as associative array. Keys represent the field names while values represent the values
    • $addTags: tags to add to the contact. Simple array of tag names (strings)
    • $removeTags: tags to remove from the contact. Simple array of tag names (strings)
    • $removeFromDNM: set this true to subscribe contact to the list, and remove it from DNM
    • $subscribeListIds: simple array of IDs of lists to subscribe the contact to
    • $unsubscribeListIds: simple array of IDs of Lists to unsubscribe the contact from
    • $unsubscribeWorkflowIds: simple array of list of IDs of workflows to unsubscribe the contact from
    • $unsubscribeCampaign: campaignID to unsubscribe the contact from

  • deleteFromAllLists(string $email)

    • Deletes specified contact from all lists
    • $email: email address of the contact

  • deleteFromLists(int $contactId, array $listIds = [])

    • Deletes the specified contact from the specified lists
    • $contactId: id of the contact
    • $listIds: simple array of ids of the lists

  • deleteContactForUid(string $uid)

    • Deletes contact having the specified UID

  • deleteListContact(int $listId, int $contactId)

    • Deletes specified contact from the specified list

  • unsubscribeAll(string $contactFieldValue, string $contactFieldName = 'email')

    • Unsubscribes contact having the specified field name/value.
    • $contactFieldValue: the value of the field for the contact(s) being unsubscribed
    • $contactFieldName: the name of the field being checked for the value. At present, the accepted field names are: 'email' or 'uid'

Journeys

Instantiation:

new Maropost.Api.Journeys($myAccountId, $myAuthToken)

Available methods:

  • get(int $page)

    • Gets the list of journeys
    • $page: page # (>= 1). Up to 200 records returned per page.

  • getCampaigns(int $journeyId, int $page)

    • Gets the list of all campaigns for the specified journey
    • $page: page # (>= 1). Up to 200 records returned per page.

  • getContacts(int $journeyId, int $page)

    • Gets the list of all contacts for the specified journey
    • $page: page # (>= 1). Up to 200 records returned per page.

  • stopAll(int $contactId, string $recipientEmail, string $uid)

    • Stops all journeys, filtered for the matching parameters
    • $contactId: this filter ignored unless greater than 0
    • $recipientEmail: this filter ignored if null
    • $uid: this filter ignored if null

  • pauseJourneyForContact(int $journeyId, int $contactId)

    • Pause the specified journey for the specified contact

  • pauseJourneyForUid(int $journeyId, string $uid)

    • Pause the specified journey for the contact having the specified UID

  • resetJourneyForContact(int $journeyId, int $contactId)

    • Reset the specified journey for the specified active/paused contact. Resetting a contact to the beginning of the journeys will result in sending of the same journey campaigns as originally sent.

  • public function resetJourneyForUid(int $journeyId, string $uid)

    • Reset the specified journey for the active/paused contact having the specified UID. Resetting a contact to the beginning of the journeys will result in sending of the same journey campaigns as originally sent.

  • public function startJourneyForContact(int $journeyId, int $contactId)

    • Restarts a journey for a paused contact. Adds a new contact in journey. Retriggers the journey for a contact who has finished its journey once. (To retrigger, make sure that "Retrigger Journey" option is enabled.)

  • startJourneyForUid(int $journeyId, string $uid)

    • Restarts a journey for a paused contact having the specified UID. Adds a new contact in journey. Retriggers the journey for a contact who has finished its journey once. (To retrigger, make sure that "Retrigger Journey" option is enabled.)

Product and Revenue

Instantiation:

new Maropost.Api.ProductAndRevenue($myAccountId, $myAuthToken)

Available methods:

  • getOrder(int $id)

    • Gets the specified order

  • getOrderForOriginalOrderId(string $originalOrderId)

    • Gets the specified order

  • createOrder(bool $requireUnique, string $contactEmail, string $contactFirstName, string $contactLastName, string $orderDateTime, string $orderStatus, string $originalOrderId, array $orderItems, array $customFields = null, array $addTags = null, array $removeTags = null, string $uid = null, string $listIds = null, string $grandTotal = null, int $campaignId = null, string $couponCode = null)

    • Creates an order
    • $requireUnique: true to validate that the order has a unique original_order_id for the given contact.
    • $contactEmail
    • $contactFirstName
    • $contactLastName
    • $orderDateTime: uses the format: "YYYY-MM-DDTHH:MM:SS-05:00"
    • $orderStatus
    • $originalOrderId: sets the original_order_id field
    • $orderItems an array of \Maropost\Api\InputTypes\OrderItemInput objects.
    • $customFields associative array where the key (string) represents the field name and the value is the field value
    • $addTags simple array of tags to add (scalar values)
    • $removeTags simple array of tags to remove (scalar values)
    • $uid
    • $listIds CSV list of IDs (e.g, "12,13")
    • $grandTotal
    • $campaignId
    • $couponCode

  • updateOrderForOriginalOrderId(string $originalOrderId, string $orderDateTime, string $orderStatus, array $orderItems, int $campaignId = null, string $couponCode = null)

    • Updates an existing eCommerce order using unique original_order_id if the details are changed due to partial return or some other update.
    • $originalOrderId: matches the original_order_id field of the order
    • $orderDateTime: uses the format: YYYY-MM-DDTHH:MM:SS-05:00
    • $orderStatus
    • $orderItems: restates the orderItems as as array of OrderItemInput objects.
    • $campaignId
    • $couponCode

  • updateOrderForOrderId(int $orderId, string $orderDateTime, string $orderStatus, array $orderItems, int $campaignId = null, string $couponCode = null)

    • Updates an existing eCommerce order using unique order_id if the details are changed due to partial return or
    • some other update.
    • $orderId: matches the Maropost order_id field of the order
    • $orderDateTime: uses the format: YYYY-MM-DDTHH:MM:SS-05:00
    • $orderStatus
    • $orderItems: restates the orderItems as as array of OrderItemInput objects.
    • $campaignId
    • $couponCode

  • deleteForOriginalOrderId(string $originalOrderId)

    • Deletes the complete eCommerce order if the order is cancelled or returned
    • $originalOrderId matches the original_order_id field of the order

  • deleteForOrderId(int $id)

    • Deletes the complete eCommerce order if the order is cancelled or returned using Maropost order id
    • $id: Maropost order_id

  • deleteProductsForOriginalOrderId(string $originalOrderId, array $productIds)

    • Deletes the specified product(s) from a complete eCommerce order if the product(s) is cancelled or returned
    • $originalOrderId: matches the original_order_id field of the order
    • $productIds: the product(s) to delete from the order

  • deleteProductsForOrderId(int $id, array $productIds)

    • Deletes the specified product(s) from a complete eCommerce order if the product(s) is cancelled or returned
    • $id: Maropost order_id
    • $productIds: the product(s) to delete from the order

Relational Tables

Instantiation:

Unlike the other services, the constructor for this requires a third parameter: $tableName. So for example:

$svc = new Maropost.Api.RelationalTables($myAccountId, $myAuthToken, $tableName);

$tableName sets which relational table the service's operations should act against. To switch tables, you do not need to re-instantiate the service. Instead, you can call

$svc->_setTableName($newTableName);

You can also call _getTableName() to determine which table is currently set.

Available functions:

  • get()

    • Gets the records of the Relational Table

  • show(int $id)

    • Gets the specified record from the Relational Table
    • $id: ID of the existing record you wish to read

  • create(KeyValue... $keyValues)

    • Adds a record to the Relational Table
    • ...$keyValues: Multiple Maropost.Api.InputTypes.KeyValue objects, for the record to be created, each item consisting of two fields:
      • $key: string representing the name of the field
      • $value: scalar value representing the new value for the field.
        • Any DateTime strings must be in one of three formats: "MM/DD/YYYY", "YYYY-MM-DD", or "YYYY-MM-DDThh:mm:ssTZD".
      • NOTE: One of the KeyValues must represent the unique identifier.

  • update(KeyValue... $keyValues)

    • Updates a record in the Relational Table.
    • ...$keyValues: Multiple Maropost.Api.InputTypes.KeyValue objects, for the record to be updated, each item consisting of two fields:
      • $key: string representing the name of the field
      • $value: scalar value representing the new value for the field.
        • Any DateTime strings must be in one of three formats: "MM/DD/YYYY", "YYYY-MM-DD", or "YYYY-MM-DDThh:mm:ssTZD".
      • NOTE: One of the KeyValues must represent the unique identifier.

  • upsert(KeyValue... $keyValues)

    • Creates or updates a record in the Relational Table.
    • ...$keyValues: Multiple Maropost.Api.InputTypes.KeyValue objects, for the record to be created or updated, each item consisting of two fields:
      • $key: string representing the name of the field
      • $value: scalar value representing the new value for the field.
        • Any DateTime strings must be in one of three formats: "MM/DD/YYYY", "YYYY-MM-DD", or "YYYY-MM-DDThh:mm:ssTZD".
      • NOTE: One of the KeyValues must represent the unique identifier.

  • delete(int $idFieldName, $idFieldValue)

    • Deletes the given record of the Relational Table
    • $idFieldName name of the field representing the unique identifier (E.g., "id", "email")
    • $idFieldValue value of the identifier field, for the record to delete.

Reports

Instantiation:

new Maropost.Api.Reports($myAccountId, $myAuthToken)

Available methods:

  • get(int $page)

    • returns the list of reports
    • $page: page # (>= 1). Up to 200 records returned per page.

  • getReport(int $id)

    • Gets the list of reports
    • $id: report ID

  • getOpens( int $page, array $fields = [], string $from = null, string $to = null, bool $unique = null, string $email = null, string $uid = null, int $per = null )

    • returns the list of open reports based on filters and fields provided
    • $page: page # (>= 1). Up to 200 records returned per page.
    • $fields: contact field names to retrieve
    • $from: the beginning of date range filter
    • $to: the end of the date range filter
    • $unique: when true, gets only unique opens
    • $email: filters by provided email in the contact
    • $uid: filters by uid
    • $per: determines how many records per request to receive

  • getClicks( int $page, array $fields = [], string $from = null, string $to = null, bool $unique = null, string $email = null, string $uid = null, int $per = null )

    • returns the list of click reports
    • $page: page # (>= 1). Up to 200 records returned per page.
    • $fields: plucks these contact fields if they exist
    • $from: start of specific date range filter
    • $to: end of date range filter
    • $unique: if true, gets unique records
    • $email: gets Clicks for specific email
    • $uid: gets Clicks for provided uid
    • $per: gets the specified number of records

  • getBounces( int $page, array $fields = [], string $from = null, string $to = null, bool $unique = null, string $email = null, string $uid = null, string $type = null, int $per = null )

    • returns the list of bounce reports
    • $page: page # (>= 1). Up to 200 records returned per page.
    • $fields: plucks these contact fields if they exist
    • $from: start of specific date range filter
    • $to: end of date range filter
    • $unique: if true, gets unique records
    • $email: gets Bounces for specific email
    • $uid: gets Bounces for provided uid
    • $per: gets the specified number of records

  • getUnsubscribes( int $page, array $fields = [], string $from = null, string $to = null, bool $unique = null, string $email = null, string $uid = null, int $per = null )

    • returns the list of Unsubscribes with provided filter constraints
    • $page: page # (>= 1). Up to 200 records returned per page.
    • $fields: plucks these contact fields if they exist
    • $from: start of specific date range filter
    • $to: end of date range filter
    • $unique if true, gets unique records
    • $email gets Unsubscribes for specific email
    • $uid gets Unsubscribes for provided uid
    • $per gets the specified number of records

  • getComplaints( array $fields = [], string $from = null, string $to = null, bool $unique = null, string $email = null, string $uid = null, int $per = null )

    • returns the list of complaints filtered by provided params
    • $page: page # (>= 1). Up to 200 records returned per page.
    • $fields: plucks these contact fields if they exist
    • $from: start of specific date range filter
    • $to: end of date range filter
    • $unique: if true, gets unique records
    • $email: gets Complaints for specific email
    • $uid: gets Complaints for provided uid
    • $per: gets the specified number of records

  • getAbReports( string $name, int $page, string $from = null, string $to = null, int $per = null )

    • returns the list of Ab Reports
    • $name: to get ab_reports with mentioned name
    • $page: page # (>= 1). Up to 200 records returned per page.
    • $from: beginning of date range filter
    • $to: end of date range filter
    • $per: gets the mentioned number of reports

  • getJourneys(int $page)

    • returns the list of all Journeys
    • $page: page # (>= 1). Up to 200 records returned per page.