All URIs are relative to https://api.moosend.com/v3
Method | HTTP request | Description |
---|---|---|
aBTestCampaignSummary | GET /campaigns/{CampaignID}/view_ab_summary.{Format} | AB Test Campaign Summary |
activityByLocation | GET /campaigns/{CampaignID}/stats/countries.{Format} | Activity By Location |
campaignSummary | GET /campaigns/{CampaignID}/view_summary.{Format} | Campaign Summary |
cloningAnExistingCampaign | POST /campaigns/{CampaignID}/clone.{Format} | Cloning An Existing Campaign |
creatingADraftCampaign | POST /campaigns/create.{Format} | Creating A Draft Campaign |
deletingACampaign | DELETE /campaigns/{CampaignID}/delete.{Format} | Deleting A Campaign |
getAllCampaigns | GET /campaigns.{Format} | Get All Campaigns |
getCampaignStatisticsWithPagingFiltered | GET /campaigns/{CampaignID}/stats/{Type}.{Format} | Get Campaign Statistics With Paging & Filtered |
getCampaignsByPage | GET /campaigns/{Page}.{Format} | Get Campaigns By Page |
getCampaignsByPageAndPagesize | GET /campaigns/{Page}/{PageSize}.{Format} | Get Campaigns By Page And Pagesize |
gettingAllYourSenders | GET /senders/find_all.{Format} | Getting All Your Senders |
gettingCampaignDetails | GET /campaigns/{CampaignID}/view.{Format} | Getting Campaign Details |
gettingSenderDetails | GET /senders/find_one.{Format} | Getting Sender Details |
linkActivity | GET /campaigns/{CampaignID}/stats/links.{Format} | Link Activity |
schedulingACampaign | POST /campaigns/{CampaignID}/schedule.{Format} | Scheduling A Campaign |
sendingACampaign | POST /campaigns/{CampaignID}/send.{Format} | Sending a campaign |
testingACampaign | POST /campaigns/{CampaignID}/send_test.{Format} | Testing a campaign |
unschedulingACampaign | POST /campaigns/{CampaignID}/unschedule.{Format} | Unscheduling a campaign |
updatingADraftCampaign | POST /campaigns/{CampaignID}/update.{Format} | Updating A Draft Campaign |
AbTestCampaignSummaryResponse aBTestCampaignSummary(format, apikey, campaignID)
AB Test Campaign Summary
Provides a basic summary of the results for a sent AB test campaign, separately for each version (A and B), such as the number of recipients, opens, clicks, bounces, unsubscribes, forwards etc to date.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var campaignID = "campaignID_example"; // String | The ID of the requested AB test campaign
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.aBTestCampaignSummary(format, apikey, campaignID, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. | |
campaignID | String | The ID of the requested AB test campaign |
No authorization required
- Content-Type: application/json
- Accept: application/json
ActivityByLocationResponse activityByLocation(format, apikey, campaignID)
Activity By Location
Returns a detailed report of your campaign opens (unique and total) by country.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var campaignID = "campaignID_example"; // String | The ID of the requested campaign
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.activityByLocation(format, apikey, campaignID, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. | |
campaignID | String | The ID of the requested campaign |
No authorization required
- Content-Type: application/json
- Accept: application/json
CampaignSummaryResponse campaignSummary(format, apikey, campaignID)
Campaign Summary
Provides a basic summary of the results for any sent campaign such as the number of recipients, opens, clicks, bounces, unsubscribes, forwards etc. to date.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var campaignID = "campaignID_example"; // String | The ID of the requested campaign
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.campaignSummary(format, apikey, campaignID, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. | |
campaignID | String | The ID of the requested campaign |
No authorization required
- Content-Type: application/json
- Accept: application/json
CloningAnExistingCampaignResponse cloningAnExistingCampaign(format, campaignID, apikey)
Cloning An Existing Campaign
Creates an exact copy of an existing campaign. The new campaign is created as a draft.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var campaignID = "campaignID_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.cloningAnExistingCampaign(format, campaignID, apikey, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
campaignID | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. |
CloningAnExistingCampaignResponse
No authorization required
- Content-Type: application/json
- Accept: application/json
CreatingADraftCampaignResponse creatingADraftCampaign(format, apikey, body)
Creating A Draft Campaign
Creates a new campaign in your account. This method does not send the campaign, but rather creates it as a draft, ready for sending or testing. You can choose to send either a regular campaign or an AB split campaign. Campaign content must be specified from a web location. Ignore (A/B Split Campaign Option) if you want to create a regular campaign.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var body = new MoosendApi.CreatingADraftCampaignRequest(); // CreatingADraftCampaignRequest |
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.creatingADraftCampaign(format, apikey, body, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. | |
body | CreatingADraftCampaignRequest |
CreatingADraftCampaignResponse
No authorization required
- Content-Type: application/json
- Accept: application/json
DeletingACampaignResponse deletingACampaign(format, apikey, campaignID)
Deleting A Campaign
Deletes a campaign from your account, draft or even sent.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var campaignID = "campaignID_example"; // String | The ID of the draft campaign to update.
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.deletingACampaign(format, apikey, campaignID, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. | |
campaignID | String | The ID of the draft campaign to update. |
No authorization required
- Content-Type: application/json
- Accept: application/json
GetAllCampaignsResponse getAllCampaigns(format, apikey)
Get All Campaigns
Returns a list of all campaigns in your account with detailed information. Because the results for this call could be quite big, paging information is required as input.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.getAllCampaigns(format, apikey, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. |
No authorization required
- Content-Type: application/json
- Accept: application/json
GetCampaignStatisticsWithPagingFilteredResponse getCampaignStatisticsWithPagingFiltered(format, apikey, campaignID, type, opts)
Get Campaign Statistics With Paging & Filtered
Returns a detailed list of statistics for a given campaign based on activity such as emails sent, opened, bounced, link clicked, etc. Because the results for this call could be quite big, paging information is required as input.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var campaignID = "campaignID_example"; // String | The ID of the requested AB test campaign
var type = "type_example"; // String | The type of the activity to display results for. This must be one of the following values : * Sent : To get information about when and to which recipients the campaign was sent. * Opened : To get information about who opened the campaign. * LinkClicked : To get information about who clicked on which link. * Forward : To get information about who forwarded the campaign using the relevant link on the email body and when. * Unsubscribed : To get information about who unsubscribed from the campaign by clicking on the unsubscribe link and when. * Bounced : To get information about which email recipients failed to receive the campaign. If not specified, the value Sent will be used by default.
var opts = {
'page': "page_example", // String | The page number to display results for. If not specified, the first page will be returned.
'pageSize': "pageSize_example", // String | The maximum number of results per page. This must be a positive integer up to 100. If not specified, 50 results per page will be returned. If a value greater than 100 is specified, it will be treated as 100.
'from': "from_example", // String | A date value that specifies since when to start returning results. If omitted, results will be returned from the moment the campaign was sent.
'to': "to_example" // String | A date value that specifies up to when to return results. If omitted, results will be returned up to date.
};
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.getCampaignStatisticsWithPagingFiltered(format, apikey, campaignID, type, opts, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. | |
campaignID | String | The ID of the requested AB test campaign | |
type | String | The type of the activity to display results for. This must be one of the following values : * Sent : To get information about when and to which recipients the campaign was sent. * Opened : To get information about who opened the campaign. * LinkClicked : To get information about who clicked on which link. * Forward : To get information about who forwarded the campaign using the relevant link on the email body and when. * Unsubscribed : To get information about who unsubscribed from the campaign by clicking on the unsubscribe link and when. * Bounced : To get information about which email recipients failed to receive the campaign. If not specified, the value Sent will be used by default. | |
page | String | The page number to display results for. If not specified, the first page will be returned. | [optional] |
pageSize | String | The maximum number of results per page. This must be a positive integer up to 100. If not specified, 50 results per page will be returned. If a value greater than 100 is specified, it will be treated as 100. | [optional] |
from | String | A date value that specifies since when to start returning results. If omitted, results will be returned from the moment the campaign was sent. | [optional] |
to | String | A date value that specifies up to when to return results. If omitted, results will be returned up to date. | [optional] |
GetCampaignStatisticsWithPagingFilteredResponse
No authorization required
- Content-Type: application/json
- Accept: application/json
GetCampaignsByPageResponse getCampaignsByPage(format, apikey, page)
Get Campaigns By Page
Returns a list of all campaigns in your account with detailed information. Because the results for this call could be quite big, paging information is required as input.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var page = 1.2; // Number | The page number to display results for.
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.getCampaignsByPage(format, apikey, page, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. | |
page | Number | The page number to display results for. |
No authorization required
- Content-Type: application/json
- Accept: application/json
GetCampaignsByPageAndPagesizeResponse getCampaignsByPageAndPagesize(format, apikey, page, pageSize, opts)
Get Campaigns By Page And Pagesize
Returns a list of all campaigns in your account with detailed information. Because the results for this call could be quite big, paging information is required as input.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var page = 1.2; // Number | The page number to display results for.
var pageSize = 1.2; // Number | The maximum number of results per page. This must be a positive integer up to 100. If not specified, 50 results per page will be returned. If a value greater than 100 is specified, it will be treated as 100.
var opts = {
'shortBy': "shortBy_example", // String | The name of the campaign property to sort results by. If not specified, results will be sorted by the CreatedOn property
'sortMethod': "sortMethod_example" // String | The method to sort results: ASC for ascending, DESC for descending. If not specified, `ASC` will be assumed
};
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.getCampaignsByPageAndPagesize(format, apikey, page, pageSize, opts, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. | |
page | Number | The page number to display results for. | |
pageSize | Number | The maximum number of results per page. This must be a positive integer up to 100. If not specified, 50 results per page will be returned. If a value greater than 100 is specified, it will be treated as 100. | |
shortBy | String | The name of the campaign property to sort results by. If not specified, results will be sorted by the CreatedOn property | [optional] |
sortMethod | String | The method to sort results: ASC for ascending, DESC for descending. If not specified, `ASC` will be assumed | [optional] |
GetCampaignsByPageAndPagesizeResponse
No authorization required
- Content-Type: application/json
- Accept: application/json
GettingAllYourSendersResponse gettingAllYourSenders(format, apikey)
Getting All Your Senders
Gets a list of your active senders in your account. You may specify any email address of these senders when sending a campaign.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.gettingAllYourSenders(format, apikey, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. |
No authorization required
- Content-Type: application/json
- Accept: application/json
GettingCampaignDetailsResponse gettingCampaignDetails(format, apikey, campaignID)
Getting Campaign Details
Returns a complete set of properties that describe the requested campaign in detail. No statistics are included in the result.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var campaignID = "campaignID_example"; // String | The ID of the requested campaign
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.gettingCampaignDetails(format, apikey, campaignID, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. | |
campaignID | String | The ID of the requested campaign |
GettingCampaignDetailsResponse
No authorization required
- Content-Type: application/json
- Accept: application/json
GettingSenderDetailsResponse gettingSenderDetails(format, email, apikey)
Getting Sender Details
Returns basic information for the specified sender identified by its email address.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var email = "email_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.gettingSenderDetails(format, email, apikey, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
String | |||
apikey | String | You may find your API Key or generate a new one in your account settings. |
No authorization required
- Content-Type: application/json
- Accept: application/json
LinkActivityResponse linkActivity(format, apikey, campaignID)
Link Activity
Returns a list with your campaign links and how many clicks have been made by your recipients, either unique or total.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var campaignID = "campaignID_example"; // String | The ID of the requested campaign
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.linkActivity(format, apikey, campaignID, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. | |
campaignID | String | The ID of the requested campaign |
No authorization required
- Content-Type: application/json
- Accept: application/json
SchedulingACampaignResponse schedulingACampaign(format, apikey, campaignID, body)
Scheduling A Campaign
Assigns a scheduled date and time at which the campaign will be delivered.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var campaignID = "campaignID_example"; // String | The ID of the campaign to be scheduled
var body = new MoosendApi.SchedulingACampaignRequest(); // SchedulingACampaignRequest |
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.schedulingACampaign(format, apikey, campaignID, body, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. | |
campaignID | String | The ID of the campaign to be scheduled | |
body | SchedulingACampaignRequest |
No authorization required
- Content-Type: application/json
- Accept: application/json
SendingACampaignResponse sendingACampaign(format, apikey, campaignID)
Sending a campaign
Sends an existing draft campaign to all recipients specified in its mailing list. The campaign is sent immediatelly.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var campaignID = "campaignID_example"; // String | The ID of the draft campaign to be sent.
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.sendingACampaign(format, apikey, campaignID, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. | |
campaignID | String | The ID of the draft campaign to be sent. |
No authorization required
- Content-Type: application/json
- Accept: application/json
TestingACampaignResponse testingACampaign(format, apikey, campaignID, body)
Testing a campaign
Sends a test email of a draft campaign to a list of email addresses you specify for previewing.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var campaignID = "campaignID_example"; // String | The ID of the draft campaign to be tested.
var body = new MoosendApi.TestingACampaignRequest(); // TestingACampaignRequest |
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.testingACampaign(format, apikey, campaignID, body, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. | |
campaignID | String | The ID of the draft campaign to be tested. | |
body | TestingACampaignRequest |
No authorization required
- Content-Type: application/json
- Accept: application/json
UnschedulingACampaignResponse unschedulingACampaign(format, apikey, campaignID)
Unscheduling a campaign
Removes a previously defined scheduled date and time from a campaign, so that it will be delivered immediately if already queued or when sent.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var campaignID = "campaignID_example"; // String | The ID of the campaign to be scheduled
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.unschedulingACampaign(format, apikey, campaignID, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. | |
campaignID | String | The ID of the campaign to be scheduled |
No authorization required
- Content-Type: application/json
- Accept: application/json
UpdatingADraftCampaignResponse updatingADraftCampaign(format, apikey, campaignID, body)
Updating A Draft Campaign
Updates properties of an existing draft A/B campaign in your account. Non-draft campaigns cannot be updated. Ignore (A/B Split Campaign Option) if you want to create a regular campaign.
var MoosendApi = require('moosend_api');
var apiInstance = new MoosendApi.CampaignsApi();
var format = "format_example"; // String |
var apikey = "apikey_example"; // String | You may find your API Key or generate a new one in your account settings.
var campaignID = "campaignID_example"; // String | The ID of the draft campaign to update.
var body = new MoosendApi.UpdatingADraftCampaignRequest(); // UpdatingADraftCampaignRequest |
var callback = function(error, data, response) {
if (error) {
console.error(error);
} else {
console.log('API called successfully. Returned data: ' + data);
}
};
apiInstance.updatingADraftCampaign(format, apikey, campaignID, body, callback);
Name | Type | Description | Notes |
---|---|---|---|
format | String | ||
apikey | String | You may find your API Key or generate a new one in your account settings. | |
campaignID | String | The ID of the draft campaign to update. | |
body | UpdatingADraftCampaignRequest |
UpdatingADraftCampaignResponse
No authorization required
- Content-Type: application/json
- Accept: application/json