Laposta

Learn how to use Laposta with Composio

Overview

SLUG: LAPOSTA

Description

Dutch newsletter app (email marketing) that makes it exceptionally easy to send professional newsletters.

Authentication Details

generic_api_key
stringRequired

Connecting to Laposta

Create an auth config

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

1

Select App

Navigate to Laposta.

2

Configure Auth Config Settings

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

3

Create and Get auth config ID

Click “Create Laposta 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

1from composio import Composio
2
3# Replace these with your actual values
4laposta_auth_config_id = "ac_YOUR_LAPOSTA_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/app
6
7composio = Composio()
8
9def 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 Laposta for user {user_id}")
22 print(f"Connection status: {connection_request.status}")
23
24 return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, laposta_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

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

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

Tool List

Tool Name: Get All Campaigns

Description

Tool to retrieve all campaigns from Laposta account. Use when you need to list all email campaigns with their configuration and delivery status.

Action Parameters

Action Response

data
array
error
successful
booleanRequired

Tool Name: Create Custom Field

Description

Tool to create a custom field for a mailing list to define subscriber attributes. Use when you need to add custom fields like text, numeric, date, or select fields to a list. For select fields (select_single or select_multiple), you must provide the options parameter.

Action Parameters

datatype
stringRequired
datatype_display
defaultvalue
in_form
booleanRequired
in_list
booleanRequired
list_id
stringRequired
name
stringRequired
options
required
booleanRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Field

Description

Tool to permanently remove a custom field from a mailing list. Use when you need to delete a field that is no longer needed.

Action Parameters

field_id
stringRequired
list_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Field Details

Description

Tool to retrieve specific field details by field_id. Use when you need to fetch complete information about a custom field including its configuration, data type, and available options.

Action Parameters

field_id
stringRequired
list_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All Fields

Description

Tool to retrieve all fields for a specific list in Laposta. Use when you need to see all field definitions, metadata, and settings for a list.

Action Parameters

list_id
stringRequired

Action Response

data
arrayRequired
error
successful
booleanRequired

Tool Name: Update Field

Description

Tool to modify field configuration in a Laposta list. Use when you need to update field properties such as name, datatype, required status, or display settings. WARNING: Modifying datatype removes all data from that field.

Action Parameters

datatype
datatype_display
defaultvalue
field_id
stringRequired
in_form
in_list
list_id
stringRequired
name
options_full
required

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Clear All Members From List

Description

Tool to clear all active members from a list. Use when you need to remove all active member relationships while preserving the list itself. The operation is permanent and cannot be undone.

Action Parameters

list_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Mailing List

Description

Tool to create a new mailing list in Laposta to manage email subscribers. Use when you need to create a new list with zero members.

Action Parameters

locked
name
stringRequired
remarks
subscribe_notification_email
unsubscribe_notification_email

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete List

Description

Tool to permanently remove a mailing list from Laposta. Use when you need to delete a list that is no longer needed. The list cannot be recovered after deletion.

Action Parameters

list_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get List Details

Description

Tool to retrieve specific list details by list_id. Use when you need to fetch complete information about a mailing list including its metadata, state, notification settings, and member statistics.

Action Parameters

list_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All Lists

Description

Tool to retrieve all mailing lists from your Laposta account. Use when you need to view all lists including both active and deleted ones.

Action Parameters

Action Response

data
arrayRequired
error
successful
booleanRequired

Tool Name: Update Mailing List

Description

Tool to modify list properties such as name, remarks, or notification emails. Use when you need to update an existing mailing list's configuration.

Action Parameters

list_id
stringRequired
locked
name
remarks
subscribe_notification_email
unsubscribe_notification_email

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Create Member

Description

Tool to add a new subscriber relationship to a list with custom fields and tracking info. Use when you need to create a new member in a list or update an existing member if upsert is enabled.

Action Parameters

custom_fields
email
stringRequired
ip
stringRequired
list_id
stringRequired
options
source_url

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Member

Description

Tool to permanently remove a member from a list. Use when you need to delete a member by their ID or email address.

Action Parameters

list_id
stringRequired
member_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Member

Description

Tool to retrieve specific member details by member_id or email. Use when you need to get comprehensive information about a member from a list, including their status, registration details, and custom field values.

Action Parameters

list_id
stringRequired
member_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All Members

Description

Tool to retrieve all members from a specified Laposta mailing list. Use when you need to list or view all contacts in a list. Optionally filter by member state (active, unsubscribed, or cleaned).

Action Parameters

list_id
stringRequired
state

Action Response

data
arrayRequired
error
successful
booleanRequired

Tool Name: Update Member

Description

Tool to modify member data, status, or custom fields in a Laposta list. Use when updating existing member information or managing subscription state. Supports partial updates (only modified fields need to be included).

Action Parameters

custom_fields
email
list_id
stringRequired
member_id
stringRequired
state

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All Campaign Reports

Description

Tool to retrieve performance metrics for all campaigns. Use when you need campaign statistics including opens, clicks, bounces, complaints, and unsubscribes.

Action Parameters

Action Response

data
arrayRequired
error
successful
booleanRequired

Tool Name: Get All Segments

Description

Tool to retrieve all segments from a mailing list. Use when you need to list or browse segments within a specific list.

Action Parameters

list_id
stringRequired

Action Response

data
arrayRequired
error
successful
booleanRequired

Tool Name: Create Webhook

Description

Tool to register a new webhook for list events in Laposta. Use when you need to receive real-time notifications for subscriber events like subscriptions, modifications, or deactivations.

Action Parameters

blocked
booleanRequired
event
stringRequired
list_id
stringRequired
url
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Delete Webhook

Description

Tool to permanently remove a webhook. Use when you need to delete a webhook from a list. Pending webhook requests are completed before deletion.

Action Parameters

list_id
stringRequired
webhook_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get Webhook Details

Description

Tool to retrieve specific webhook details by webhook_id. Use when you need to inspect webhook configuration including event type, URL, and status.

Action Parameters

list_id
stringRequired
webhook_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired

Tool Name: Get All Webhooks

Description

Tool to retrieve all webhooks for a specific list. Use when you need to view all webhooks configured for a particular list.

Action Parameters

list_id
stringRequired

Action Response

data
arrayRequired
error
successful
booleanRequired

Tool Name: Update Webhook

Description

Tool to modify webhook configuration including URL, event type, or blocked status. Use when you need to update an existing webhook's settings.

Action Parameters

blocked
event
list_id
stringRequired
url
webhook_id
stringRequired

Action Response

data
objectRequired
error
successful
booleanRequired