moosend_add_subscriber

WRITE: add one subscriber to a mailing list. If the email already exists in the list, that subscriber is UPDATED instead (and custom fields you omit are cleared). A previously unsubscribed address is re-subscribed. Rate limit 10 calls / 10 s. Moosend: POST /subscribers/{MailingListID}/subscribe.json.

destructive

Argument	Type	Description
name	string	Subscriber name.
tags	array	Subscriber tags.
email*	string	Subscriber email address.
preferences	array	Preference option values chosen by the subscriber (must match the list's preference options).
custom_fields	object	Custom field values by field name, e.g. {"City":"Athens","Age":25}. Sent to Moosend as "Name=Value" pairs. WARNING: on an existing subscriber, any custom field NOT included is cleared — include every field you want to keep.
mailing_list_id*	string	Mailing list ID (a GUID, from moosend_list_mailing_lists).
has_external_double_opt_in	boolean	True if the subscriber already gave consent by other means.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "mailing_list_id",
    "email"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Subscriber name."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Subscriber tags."
    },
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Subscriber email address."
    },
    "preferences": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Preference option values chosen by the subscriber (must match the list's preference options)."
    },
    "custom_fields": {
      "type": "object",
      "description": "Custom field values by field name, e.g. {\"City\":\"Athens\",\"Age\":25}. Sent to Moosend as \"Name=Value\" pairs. WARNING: on an existing subscriber, any custom field NOT included is cleared — include every field you want to keep.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    },
    "mailing_list_id": {
      "type": "string",
      "minLength": 1,
      "description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
    },
    "has_external_double_opt_in": {
      "type": "boolean",
      "description": "True if the subscriber already gave consent by other means."
    }
  }
}

moosend_create_draft_campaign

WRITE: create a regular (non-A/B) DRAFT campaign. It is NOT sent — sending stays a human action in Moosend. Give the content as html_content or a web_location URL. sender_email and reply_to_email must be senders in the account (see moosend_list_senders). Returns the new campaign's ID. Moosend: POST /campaigns/create.json.

destructive

Argument	Type	Description
name*	string	Campaign name.
subject*	string	Subject line.
html_content	string	Complete HTML body of the campaign.
sender_email*	string	Sender email — must be one of the account's senders.
web_location	string	URL Moosend fetches the HTML from (CSS is inlined automatically).
mailing_lists*	array	Target lists, each optionally narrowed to one segment.
reply_to_email	string	Reply-to email — must be one of the account's senders. Default: sender_email.
confirmation_to_email

moosend_create_mailing_list

WRITE: create a new, empty mailing list. Returns the new list's ID. Moosend: POST /lists/create.json.

destructive

Argument	Type	Description
name*	string	List name.
preferences	object	Optional preference field for the list. Omit for none.
confirmation_page	string	URL shown at the end of the subscription process.
redirect_after_unsubscribe_page	string	URL subscribers are redirected to after unsubscribing.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "List name."
    },
    "preferences": {
      "type": "object",
      "required": [
        "select_type",
        "options"
      ],
      "properties": {
        "options": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 10,
          "description": "Up to 10 preference options."
        },
        "is_required": {
          "type": "boolean",
          "description": "Whether a choice is required. Default false."
        },
        "select_type": {
          "enum": [
            "SingleSelect",
            "MultiSelect"
          ],
          "type": "string",
          "description": "Single- or multi-select."
        }
      },
      "description": "Optional preference field for the list. Omit for none."
    },
    "confirmation_page": {
      "type": "string",
      "description": "URL shown at the end of the subscription process."
    },
    "redirect_after_unsubscribe_page": {
      "type": "string",
      "description": "URL subscribers are redirected to after unsubscribing."
    }
  }
}

moosend_get_campaign

Get one campaign's details: subject, sender and reply-to, HTML and plain content, target lists/segments, schedule, status and A/B data. No statistics (use moosend_get_campaign_summary). Moosend: GET /campaigns/{CampaignID}/view.json.

read-only

Argument	Type	Description
campaign_id*	string	Campaign ID (a GUID, from moosend_list_campaigns).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "campaign_id"
  ],
  "properties": {
    "campaign_id": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID (a GUID, from moosend_list_campaigns)."
    }
  }
}

moosend_get_campaign_activity

Per-recipient activity for a campaign by type: Sent, Opened, LinkClicked, Unsubscribed, Bounced, Complained, or Activity (all). Paged (default 50, max 1000) and filterable by date. NOTE: Moosend rate-limits this endpoint to 2 calls per 60 seconds per API key. Moosend: GET /campaigns/{CampaignID}/stats/{Type}.json.

read-only

Argument	Type	Description
to	string	End date, DD-MM-YYYY. Default: today.
from	string	Start date, DD-MM-YYYY. Default: the send date.
page	integer	Page number, starting at 1. Default 1.
type	string	Activity type. Default Sent.
page_size	integer	Results per page, 1-1000.
campaign_id*	string	Campaign ID (a GUID, from moosend_list_campaigns).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "campaign_id"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{2}-\\d{2}-\\d{4}$",
      "description": "End date, DD-MM-YYYY. Default: today."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{2}-\\d{2}-\\d{4}$",
      "description": "Start date, DD-MM-YYYY. Default: the send date."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, starting at 1. Default 1."
    },
    "type": {
      "enum": [
        "Sent",
        "Opened",
        "LinkClicked",
        "Unsubscribed",
        "Bounced",
        "Complained",
        "Activity"
      ],
      "type": "string",
      "description": "Activity type. Default Sent."
    },
    "page_size": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Results per page, 1-1000."
    },
    "campaign_id": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID (a GUID, from moosend_list_campaigns)."
    }
  }
}

moosend_get_campaign_activity_by_location

A campaign's total and unique opens broken down by country code. Moosend: GET /campaigns/{CampaignID}/stats/countries.json.

read-only

Argument	Type	Description
campaign_id*	string	Campaign ID (a GUID, from moosend_list_campaigns).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "campaign_id"
  ],
  "properties": {
    "campaign_id": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID (a GUID, from moosend_list_campaigns)."
    }
  }
}

moosend_get_campaign_link_activity

List every link in a campaign with its total and unique click counts. Moosend: GET /campaigns/{CampaignID}/stats/links.json.

read-only

Argument	Type	Description
campaign_id*	string	Campaign ID (a GUID, from moosend_list_campaigns).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "campaign_id"
  ],
  "properties": {
    "campaign_id": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID (a GUID, from moosend_list_campaigns)."
    }
  }
}

moosend_get_campaign_summary

Get a sent campaign's results to date: sent, total/unique opens, total/unique link clicks, bounces, complaints, forwards and unsubscribes. Moosend: GET /campaigns/{CampaignID}/view_summary.json.

read-only

Argument	Type	Description
campaign_id*	string	Campaign ID (a GUID, from moosend_list_campaigns).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "campaign_id"
  ],
  "properties": {
    "campaign_id": {
      "type": "string",
      "minLength": 1,
      "description": "Campaign ID (a GUID, from moosend_list_campaigns)."
    }
  }
}

moosend_get_mailing_list

Get one mailing list: name, member counts, status, custom field definitions (id, name, type, required), preferences and the latest import operation. Moosend: GET /lists/{MailingListID}/details.json.

read-only

Argument	Type	Description
mailing_list_id*	string	Mailing list ID (a GUID, from moosend_list_mailing_lists).
with_statistics	boolean	Include subscriber statistics. Default true.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "mailing_list_id"
  ],
  "properties": {
    "mailing_list_id": {
      "type": "string",
      "minLength": 1,
      "description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
    },
    "with_statistics": {
      "type": "boolean",
      "description": "Include subscriber statistics. Default true."
    }
  }
}

moosend_get_segment

Get one segment's details and criteria (not its members). Moosend: GET /lists/{MailingListID}/segments/{SegmentID}/details.json.

read-only

Argument	Type	Description
segment_id*	any	Segment ID (an integer, from moosend_list_segments).
mailing_list_id*	string	Mailing list ID (a GUID, from moosend_list_mailing_lists).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "mailing_list_id",
    "segment_id"
  ],
  "properties": {
    "segment_id": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 0
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ],
      "description": "Segment ID (an integer, from moosend_list_segments)."
    },
    "mailing_list_id": {
      "type": "string",
      "minLength": 1,
      "description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
    }
  }
}

moosend_get_subscriber

Get one subscriber in a mailing list by subscriber ID. Moosend: GET /subscribers/{MailingListID}/find/{SubscriberID}.json.

read-only

Argument	Type	Description
subscriber_id*	string	Subscriber ID (a GUID).
mailing_list_id*	string	Mailing list ID (a GUID, from moosend_list_mailing_lists).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "mailing_list_id",
    "subscriber_id"
  ],
  "properties": {
    "subscriber_id": {
      "type": "string",
      "minLength": 1,
      "description": "Subscriber ID (a GUID)."
    },
    "mailing_list_id": {
      "type": "string",
      "minLength": 1,
      "description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
    }
  }
}

moosend_get_subscriber_by_email

Look up a subscriber in one mailing list by email address: ID, name, status (SubscribeType 1 subscribed, 2 unsubscribed, 3 bounced, 4 removed), custom fields, tags and preferences. Moosend: GET /subscribers/{MailingListID}/view.json?Email=.

read-only

Argument	Type	Description
email*	string	Subscriber email address.
mailing_list_id*	string	Mailing list ID (a GUID, from moosend_list_mailing_lists).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "mailing_list_id",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Subscriber email address."
    },
    "mailing_list_id": {
      "type": "string",
      "minLength": 1,
      "description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
    }
  }
}

moosend_list_campaigns

List campaigns with status (0 draft, 1 queued, 3 sent, 5 awaiting delivery, 6 sending, ...), delivery/schedule dates, target lists and headline stats (sent, opens, clicks, bounces, unsubscribes, complaints). Paged, up to 1000 per page. Moosend: GET /campaigns/{Page}/{PageSize}.json.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1. Default 1.
sort_by	string	Property to sort by. Default CreatedOn.
page_size	integer	Results per page, 1-1000.
sort_method	string	Sort direction. Default ASC.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, starting at 1. Default 1."
    },
    "sort_by": {
      "enum": [
        "Name",
        "Subject",
        "Status",
        "DeliveredOn",
        "CreatedOn"
      ],
      "type": "string",
      "description": "Property to sort by. Default CreatedOn."
    },
    "page_size": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Results per page, 1-1000."
    },
    "sort_method": {
      "enum": [
        "ASC",
        "DESC"
      ],
      "type": "string",
      "description": "Sort direction. Default ASC."
    }
  }
}

moosend_list_mailing_lists

List the active email (mailing) lists in the account with member counts (active, bounced, removed, unsubscribed), custom field definitions and preferences, plus paging info. A cheap way to confirm the API key works and to find list IDs. Moosend: GET /lists/{Page}/{PageSize}.json.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1. Default 1.
sort_by	string	Property to sort by. Default CreatedOn.
page_size	integer	Results per page, 1-1000.
sort_method	string	Sort direction. Default ASC.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, starting at 1. Default 1."
    },
    "sort_by": {
      "enum": [
        "Name",
        "Subject",
        "Status",
        "DeliveredOn",
        "CreatedOn"
      ],
      "type": "string",
      "description": "Property to sort by. Default CreatedOn."
    },
    "page_size": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Results per page, 1-1000."
    },
    "sort_method": {
      "enum": [
        "ASC",
        "DESC"
      ],
      "type": "string",
      "description": "Sort direction. Default ASC."
    }
  }
}

moosend_list_segment_subscribers

List the subscribers that currently match one segment's criteria. Moosend: GET /lists/{MailingListID}/segments/{SegmentID}/members.json.

read-only

Argument	Type	Description
segment_id*	any	Segment ID (an integer, from moosend_list_segments).
mailing_list_id*	string	Mailing list ID (a GUID, from moosend_list_mailing_lists).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "mailing_list_id",
    "segment_id"
  ],
  "properties": {
    "segment_id": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "minimum": 0
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ],
      "description": "Segment ID (an integer, from moosend_list_segments)."
    },
    "mailing_list_id": {
      "type": "string",
      "minLength": 1,
      "description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
    }
  }
}

moosend_list_segments

List the segments of one mailing list, including their criteria, match type (0 all / 1 any) and a readable description. Moosend: GET /lists/{MailingListID}/segments.json.

read-only

Argument	Type	Description
mailing_list_id*	string	Mailing list ID (a GUID, from moosend_list_mailing_lists).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "mailing_list_id"
  ],
  "properties": {
    "mailing_list_id": {
      "type": "string",
      "minLength": 1,
      "description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
    }
  }
}

moosend_list_senders

List the account's campaign senders (name, email, enabled, SPF/DKIM verification). A draft campaign's sender and reply-to must be one of these. Moosend: GET /senders/find_all.json.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

moosend_list_subscribers

List the subscribers of one mailing list filtered by status (Subscribed, Unsubscribed, Bounced or Removed), with name, email, custom fields, tags, preferences and dates. Paged. Moosend: GET /lists/{MailingListID}/subscribers/{Status}.json.

read-only

Argument	Type	Description
page	integer	Page number, starting at 1. Default 1.
status	string	Subscriber status to return. Default Subscribed.
page_size	integer	Results per page, 1-1000.
mailing_list_id*	string	Mailing list ID (a GUID, from moosend_list_mailing_lists).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "mailing_list_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number, starting at 1. Default 1."
    },
    "status": {
      "enum": [
        "Subscribed",
        "Unsubscribed",
        "Bounced",
        "Removed"
      ],
      "type": "string",
      "description": "Subscriber status to return. Default Subscribed."
    },
    "page_size": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Results per page, 1-1000."
    },
    "mailing_list_id": {
      "type": "string",
      "minLength": 1,
      "description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
    }
  }
}

moosend_unsubscribe_subscriber

WRITE: unsubscribe one email address from one mailing list (not account-wide). Undo by adding the subscriber again with moosend_add_subscriber. Moosend: POST /subscribers/{MailingListID}/unsubscribe.json.

destructive

Argument	Type	Description
email*	string	Email address to unsubscribe.
mailing_list_id*	string	Mailing list ID (a GUID, from moosend_list_mailing_lists).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "mailing_list_id",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Email address to unsubscribe."
    },
    "mailing_list_id": {
      "type": "string",
      "minLength": 1,
      "description": "Mailing list ID (a GUID, from moosend_list_mailing_lists)."
    }
  }
}

moosend_update_subscriber

WRITE: update one subscriber (by ID) in a mailing list — email, name, custom fields, tags, preferences. Include every custom field you want to keep. Moosend: POST /subscribers/{MailingListID}/update/{SubscriberID}.json.

destructive

Argument	Type	Description
name	string	Subscriber name.
tags	array	Subscriber tags.
email*	string	The subscriber's email address (required by Moosend).
preferences	array	Preference option values chosen by the subscriber (must match the list's preference options).
custom_fields	object	Custom field values by field name, e.g. {"City":"Athens","Age":25}. Sent to Moosend as "Name=Value" pairs. WARNING: on an existing subscriber, any custom field NOT included is cleared — include every field you want to keep.
subscriber_id*	string	Subscriber ID (a GUID).
mailing_list_id*	string	Mailing list ID (a GUID, from moosend_list_mailing_lists).

Moosend MCP by usefulapi

Try it

moosend_add_subscriber Destructive

Moosend MCP by usefulapi

Try it

moosend_add_subscriber Destructive

Tools (20)