Moosend | Composio Docs

Overview

SLUG: MOOSEND

Description

Moosend is a cloud-based, AI-powered email marketing solution that allows you to target your audience at scale.

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to Moosend

Create an auth config

Use the dashboard to create an auth config for the Moosend toolkit. This allows you to connect multiple Moosend accounts to Composio for agents to use.

Select App

Navigate to Moosend.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Moosend Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 moosend_auth_config_id = "ac_YOUR_MOOSEND_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Moosend for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, moosend_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Moosend toolkit’s playground

For code examples, see the Tool calling guide and Provider examples.

Tool List

MOOSEND_ADD_SUBSCRIBER

Tool Name: Add or Update Subscriber

Description

Tool to add or update a subscriber in a mailing list. Use after obtaining the mailing list ID to manage subscribers.

Action Parameters

CustomFields

HasExternalDoubleOptIn

Name

Preferences

MOOSEND_CREATE_CUSTOM_FIELD

Tool Name: Create custom field

Description

Tool to create a custom field in a mailing list. Use when you need to define a new custom field for subscriber data.

Action Parameters

custom_field_type

stringDefaults to Text

format

stringDefaults to json

is_hidden

is_required

mailing_list_id

stringRequired

name

stringRequired

options

Action Response

data

objectRequired

error

successful

booleanRequired

MOOSEND_CREATE_MAILING_LIST

Tool Name: Create Mailing List

Description

Tool to create a new empty mailing list in Moosend. Use after obtaining API key.

Action Parameters

ConfirmationPage

Name

stringRequired

PreferencePageId

Preferences

objectRequired

RedirectAfterUnsubscribePage

Action Response

data

objectRequired

error

successful

booleanRequired

MOOSEND_DELETE_CAMPAIGN

Tool Name: Delete Campaign

Description

Tool to delete a campaign. Use when you need to permanently remove a draft or sent campaign from your Moosend account after confirming its ID. Deletion is irreversible.

Action Parameters

campaign_id

stringRequired

format

stringDefaults to json

Action Response

data

objectRequired

error

successful

booleanRequired

MOOSEND_DELETE_CUSTOM_FIELD

Tool Name: Delete custom field

Description

Tool to remove a custom field definition from a mailing list. Use when you have confirmed the custom field ID to delete.

Action Parameters

custom_field_id

stringRequired

format

stringDefaults to json

mailing_list_id

stringRequired

Action Response

data

objectRequired

error

successful

booleanRequired

MOOSEND_DELETE_MAILING_LIST

Tool Name: Delete Mailing List

Description

Tool to delete a mailing list. Use when you need to permanently remove a mailing list from your Moosend account after confirming its ID. Deletion is irreversible.

Action Parameters

format

stringDefaults to json

mailing_list_id

stringRequired

Action Response

data

objectRequired

error

successful

booleanRequired

MOOSEND_GET_ALL_CAMPAIGNS

Tool Name: Get all campaigns

Description

Tool to retrieve a list of all campaigns in your account. Use after acquiring valid API credentials to explore campaign data.

Action Parameters

format

stringDefaults to json

page

Defaults to 1

Action Response

data

objectRequired

error

successful

booleanRequired

MOOSEND_GET_ALL_SUBSCRIBERS

Tool Name: Get All Subscribers

Description

Tool to retrieve subscribers in a specified mailing list by status. Use when you need to paginate subscribers after confirming list ID and status.

Action Parameters

Page

PageSize

format

stringDefaults to json

mailingListID

stringRequired

status

stringRequired

Action Response

data

objectRequired

error

successful

booleanRequired

MOOSEND_GET_CAMPAIGN_DETAILS

Tool Name: Get Campaign Details

Description

Tool to retrieve detailed properties of a specific campaign. Use when you need to inspect a campaign's full configuration after creation or scheduling.

Action Parameters

campaign_id

stringRequired

format

stringDefaults to json

Action Response

data

objectRequired

error

successful

booleanRequired

MOOSEND_GET_SUBSCRIBER_BY_EMAIL

Tool Name: Get Subscriber By Email

Description

Tool to search for a subscriber by email in a mailing list. Use when you need subscriber details after confirming the list exists. Example: "Get subscriber details for jane.doe@example.com in list 04fad8e2-..."

Action Parameters

stringRequired

format

stringDefaults to json

mailingListID

stringRequired

Action Response

data

objectRequired

error

successful

booleanRequired

MOOSEND_SCHEDULE_CAMPAIGN

Tool Name: Schedule Campaign

Description

Tool to schedule a campaign. Use when you want to set a specific date and time for campaign delivery after confirming its ID.

Action Parameters

ScheduledDateTime

stringRequired

TimeZone

campaign_id

stringRequired

format

stringDefaults to json

Action Response

data

objectRequired

error

successful

booleanRequired

MOOSEND_SEND_CAMPAIGN

Tool Name: Send Campaign

Description

Tool to send an existing draft campaign immediately. Use when you want to dispatch a campaign to all recipients after final review.

Action Parameters

CampaignID

stringRequired

Format

stringDefaults to json

Action Response

data

objectRequired

error

successful

booleanRequired

MOOSEND_UPDATE_CAMPAIGN

Tool Name: Update Campaign

Description

Tool to update a draft campaign. Use when you want to modify properties of an existing draft campaign before sending.

Action Parameters

ABCampaignType

ABWinnerSelectionType

CampaignID

stringRequired

ConfirmationToEmail

HTMLContentB

HoursToTest

IsAB

ListPercentage

MailingLists

Name

stringRequired

ReplyToEmail

SenderEmail

SenderEmailB

Subject

SubjectB

TrackInGoogleAnalytics

WebLocation

WebLocationB

format

stringDefaults to json

Action Response

data

objectRequired

error

successful

booleanRequired

MOOSEND_UPDATE_CUSTOM_FIELD

Tool Name: Update custom field

Description

Tool to update properties of an existing custom field in a mailing list. Use after confirming mailing list and custom field IDs.

Action Parameters

custom_field_id

stringRequired

custom_field_type

format

stringDefaults to json

is_hidden

boolean

is_required

boolean

mailing_list_id

stringRequired

name

stringRequired

options

Action Response

data

objectRequired

error

successful

booleanRequired

MOOSEND_UPDATE_MAILING_LIST

Tool Name: Update Mailing List

Description

Tool to update the properties of an existing mailing list. Use when you need to change list metadata after confirming the list ID.

Action Parameters

description

format

stringDefaults to json

mailing_list_id

stringRequired

name

reply_to_email

sender_email

sender_name

Action Response

data

objectRequired

error

successful

booleanRequired