Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Laposta

Scalekit connector
Open markdown

The Laposta connector lets your AI agent act in each user's Laposta account. Each user connects their own Laposta API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 46 tools.

Tools
46
What they doRead · write · destructive
19 · 20 · 719 read20 write7 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Laposta connection

    In AgentKit > Connections, create a Laposta connection. The name you give it is the connection_name your code passes. See Configure connections.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • laposta_automation_getGet one Laposta automation.Read-only

    Get Automation

    Get one Laposta automation. Returns the automation object with automation_id, name, status, started count and dates. Use laposta_automations_list to find the ID.

    Inputs

    automation_idstringrequired
    ID of the automation. Find it with laposta_automations_list. Example: pdq4k7wqcm.
  • laposta_automations_listList the automations in the Laposta account, optionally only active or inactive ones.Read-only

    List Automations

    List the automations in the Laposta account, optionally only active or inactive ones. Deleted automations are left out. Returns data[] of automation objects with automation_id, name, status and started count. Use laposta_automation_get for one automation.

    Inputs

    statusstring
    Only automations with this status: active or inactive. Leave empty for all.one of activeinactive
  • laposta_campaign_content_getGet the HTML content of a Laposta campaign.Read-only

    Get Campaign Content

    Get the HTML content of a Laposta campaign. Works only for campaigns filled with HTML or an import URL, not drag-and-drop campaigns. Returns the campaign_id, plain html and import_url. Use laposta_campaign_content_update to change it.

    Inputs

    campaign_idstringrequired
    ID of the campaign. Find it with laposta_campaigns_list. Example: njhgaf61ye.
  • laposta_campaign_getGet one Laposta campaign.Read-only

    Get Campaign

    Get one Laposta campaign. Returns the campaign object: name, subject, previewtext, from, reply_to, list_ids, delivery times, web version URL and screenshots. Use laposta_campaigns_list to find the campaign_id.

    Inputs

    campaign_idstringrequired
    ID of the campaign. Find it with laposta_campaigns_list. Example: njhgaf61ye.
  • laposta_campaign_history_getGet the event history of a Laposta campaign: sends, opens, clicks, bounces, unsubscribes and complaints per subscriber.Read-only

    Get Campaign History

    Get the event history of a Laposta campaign: sends, opens, clicks, bounces, unsubscribes and complaints per subscriber. Returns data[] of events with type, event_date, member and details, plus pagination with has_more and next_cursor. Use laposta_report_get for totals only.

    Inputs

    campaign_idstringrequired
    ID of the campaign. Find it with laposta_campaigns_list. Example: njhgaf61ye.
    cursorstring
    pagination.next_cursor from the previous page, sent back unchanged. Keep the same filters when paging.
    event_date_fromstring
    Only events from this date and time, inclusive. Regular format YYYY-MM-DD HH:MM:SS (account timezone) or ISO 8601. Example: 2026-04-01 00:00:00.
    event_date_tostring
    Only events before this date and time, exclusive. Regular format YYYY-MM-DD HH:MM:SS (account timezone) or ISO 8601. Example: 2026-05-01 00:00:00.
    limitinteger
    Maximum events per page, 1-1000 (Laposta default 100). Example: 100.
    orderstring
    Sort direction, desc (default) or asc.one of descasc
    order_bystring
    Field to sort by. Only event_date is supported.one of event_date
  • laposta_campaigns_listList the campaigns in the Laposta account, optionally only drafts or only sent ones.Read-only

    List Campaigns

    List the campaigns in the Laposta account, optionally only drafts or only sent ones. Returns data[] of campaign objects with campaign_id, name, subject, from, list_ids and delivery times. Use laposta_campaign_get for one campaign and laposta_report_get for its results.

    Inputs

    statusstring
    Only draft campaigns (not sent yet, including scheduled) or sent ones (sending or sent). Leave empty for all.one of draftsent
  • laposta_field_getGet one field of a Laposta list.Read-only

    Get Field

    Get one field of a Laposta list. Returns the field object: field_id, name, tag, custom_name, datatype, defaultvalue, options and options_full, required, in_form and in_list. Use laposta_fields_list to find the field_id.

    Inputs

    field_idstringrequired
    ID of the field. Example: gt2Em8vJwi.
    list_idstringrequired
    ID of the Laposta list. Find it with laposta_lists_list or in the app under Subscribers > the list > Attributes list. Example: BaImMu3JZA.
  • laposta_fields_listList all fields of a Laposta list, including the built-in email field and the labels field if the list uses labels.Read-only

    List Fields

    List all fields of a Laposta list, including the built-in email field and the labels field if the list uses labels. Returns data[] of field objects with field_id, name, custom_name, datatype, options, required, in_form and in_list. Use the custom_name values as keys in custom_fields when adding or updating subscribers.

    Inputs

    list_idstringrequired
    ID of the Laposta list. Find it with laposta_lists_list or in the app under Subscribers > the list > Attributes list. Example: BaImMu3JZA.