# Laposta

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

- **Category:** email newsletters
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 25
- **Triggers:** 0
- **Slug:** `LAPOSTA`
- **Version:** 20260227_00

## Tools

### Get All Campaigns

**Slug:** `LAPOSTA_CAMPAIGN_GET_ALL`

Retrieve all email campaigns from your Laposta account. Use this tool to list all campaigns with their configuration, delivery status, and analytics settings. Returns campaign details including sender information, subject lines, recipient lists, delivery timestamps, and tracking settings. No parameters required - retrieves all campaigns associated with your account.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Custom Field

**Slug:** `LAPOSTA_FIELD_CREATE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Display name for the field |
| `in_form` | boolean | Yes | Whether to display in signup form |
| `in_list` | boolean | Yes | Whether to show in list overview |
| `list_id` | string | Yes | The ID of the list to which the field belongs |
| `options` | array | No | Required when datatype is select_single or select_multiple - array of choice values |
| `datatype` | string ("text" | "numeric" | "date" | "select_single" | "select_multiple") | Yes | Field type - must be one of: text, numeric, date, select_single, or select_multiple |
| `required` | boolean | Yes | Whether the field is mandatory |
| `defaultvalue` | string | No | Default value when the field is absent |
| `datatype_display` | string ("select" | "radio") | No | For select_single only - display as 'select' or 'radio' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Field

**Slug:** `LAPOSTA_FIELD_DELETE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The identifier of the list containing the field |
| `field_id` | string | Yes | The identifier of the field to remove |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Field Details

**Slug:** `LAPOSTA_FIELD_GET`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The ID of the list to which the field belongs |
| `field_id` | string | Yes | The unique identifier of the field to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get All Fields

**Slug:** `LAPOSTA_FIELD_GET_ALL`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The identifier of the list whose fields are being retrieved |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Field

**Slug:** `LAPOSTA_FIELD_UPDATE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Display name for the field |
| `in_form` | boolean | No | Display in signup form |
| `in_list` | boolean | No | Display in list overview |
| `list_id` | string | Yes | Identifier of the list containing the field |
| `datatype` | string ("text" | "numeric" | "date" | "select_single" | "select_multiple") | No | Data type for the field. WARNING: Modifying datatype removes all data from that field |
| `field_id` | string | Yes | Identifier of the field to modify |
| `required` | boolean | No | Whether field is mandatory |
| `defaultvalue` | string | No | Default value when field is absent |
| `options_full` | array | No | Array of options with 'value' and 'id' properties (for select types only). Include existing option IDs to preserve them, or omit IDs to remove options. New options can use new ID values. |
| `datatype_display` | string ("select" | "radio") | No | For select_single only - display as 'select' or 'radio' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Segment Details

**Slug:** `LAPOSTA_GET_SEGMENT`

Tool to retrieve specific segment details by segment_id. Use when you need to fetch complete information about a segment including its name, definition criteria, and timestamps.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The identifier of the list to which the segment belongs |
| `segment_id` | string | Yes | The unique identifier of the segment to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Clear All Members From List

**Slug:** `LAPOSTA_LIST_CLEAR_MEMBERS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The identifier of the list to clear all active members from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Mailing List

**Slug:** `LAPOSTA_LIST_CREATE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | A name for the new mailing list |
| `locked` | boolean | No | If true, prevents modification by application users. Defaults to false if not specified. |
| `remarks` | string | No | Optional notes or remarks about the list |
| `subscribe_notification_email` | string | No | Email address to receive subscription notifications |
| `unsubscribe_notification_email` | string | No | Email address to receive unsubscription notifications |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete List

**Slug:** `LAPOSTA_LIST_DELETE`

Permanently deletes a mailing list from Laposta. This action is irreversible - the list and all its configuration (including notification settings and metadata) will be permanently removed. Members are not deleted, only the list itself. Use this when a mailing list is no longer needed. Returns the deleted list object with state set to 'deleted'.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The unique identifier of the mailing list to permanently delete. This is a 10-character alphanumeric ID obtained from list creation or retrieval operations. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get List Details

**Slug:** `LAPOSTA_LIST_GET`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The unique identifier of the list to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get All Lists

**Slug:** `LAPOSTA_LIST_GET_ALL`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Mailing List

**Slug:** `LAPOSTA_LIST_UPDATE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Name of the mailing list |
| `locked` | boolean | No | If true, prevents the list from being modified by application users |
| `list_id` | string | Yes | The identifier of the list to be modified |
| `remarks` | string | No | Notes or comments about the list |
| `subscribe_notification_email` | string | No | Email address to receive notifications when users subscribe to the list |
| `unsubscribe_notification_email` | string | No | Email address to receive notifications when users unsubscribe from the list |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Member

**Slug:** `LAPOSTA_MEMBER_CREATE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ip` | string | Yes | IP address from which the member signed up |
| `email` | string | Yes | Email address of the member being added |
| `list_id` | string | Yes | The ID of the list to which the member should be added |
| `options` | object | No | Options to control member creation behavior. |
| `source_url` | string | No | The URL from which the member signed up |
| `custom_fields` | object | No | Values for extra fields; uses field's custom_name as key |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Member

**Slug:** `LAPOSTA_MEMBER_DELETE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The identifier of the list containing the member |
| `member_id` | string | Yes | The member's unique identifier OR email address (special characters in emails are automatically URL-encoded) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Member

**Slug:** `LAPOSTA_MEMBER_GET`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The identifier of the list containing the member. |
| `member_id` | string | Yes | The unique identifier OR email address of the member. For email addresses with a '+' symbol, use the member_id instead or manually encode '+' as '%252B'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get All Members

**Slug:** `LAPOSTA_MEMBER_GET_ALL`

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).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `state` | string ("active" | "unsubscribed" | "cleaned") | No | Filter by member status. Accepts: 'active', 'unsubscribed', or 'cleaned' |
| `list_id` | string | Yes | The identifier of the list from which to retrieve members |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Member

**Slug:** `LAPOSTA_MEMBER_UPDATE`

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).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Updated email address for the member. |
| `state` | string ("active" | "unsubscribed") | No | New status for the member. Use 'active' to subscribe or 'unsubscribed' to unsubscribe. |
| `list_id` | string | Yes | The ID of the list containing the member. |
| `member_id` | string | Yes | Unique member identifier or URL-encoded email address. Note: '+' in email must be encoded as %252B. |
| `custom_fields` | object | No | Key-value pairs for custom/extra fields. Use field names as keys (e.g., {'voornaam': 'John', 'achternaam': 'Doe'}). Multi-choice fields can be cleared by passing empty string. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get All Campaign Reports

**Slug:** `LAPOSTA_REPORT_GET_ALL`

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get All Segments

**Slug:** `LAPOSTA_SEGMENT_GET_ALL`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The identifier for the mailing list whose segments you want to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Webhook

**Slug:** `LAPOSTA_WEBHOOK_CREATE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | The endpoint URL where webhook notifications will be posted |
| `event` | string ("subscribed" | "modified" | "deactivated") | Yes | The trigger event for the webhook. Must be one of: subscribed, modified, or deactivated |
| `blocked` | boolean | No | Whether webhook invocation is temporarily blocked. Set to false to allow webhook to fire, true to block it. Defaults to false (webhook enabled). |
| `list_id` | string | Yes | The identifier of the list to which the webhook belongs |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Webhook

**Slug:** `LAPOSTA_WEBHOOK_DELETE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The identifier of the list the webhook belongs to |
| `webhook_id` | string | Yes | The identifier of the webhook to remove |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Webhook Details

**Slug:** `LAPOSTA_WEBHOOK_GET`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The identifier of the list to which the webhook belongs |
| `webhook_id` | string | Yes | The unique identifier of the webhook to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get All Webhooks

**Slug:** `LAPOSTA_WEBHOOK_GET_ALL`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | The identifier of the list for which webhooks are retrieved. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Webhook

**Slug:** `LAPOSTA_WEBHOOK_UPDATE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | Target endpoint URL for webhook POST requests |
| `event` | string ("subscribed" | "modified" | "deactivated") | No | Trigger condition for the webhook. Accepted values: 'subscribed', 'modified', or 'deactivated' |
| `blocked` | boolean | No | Whether webhook invocation is temporarily suspended |
| `list_id` | string | Yes | Identifier of the associated list |
| `webhook_id` | string | Yes | Unique identifier of the webhook to modify |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |