Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Mailjet

Scalekit connector
Open markdown

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

Tools
63
What they doRead · write · destructive
31 · 26 · 631 read26 write6 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 Mailjet connection

    In AgentKit > Connections, create a Mailjet 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
  • mailjet_campaign_draft_getRetrieve one campaign draft.Read-only

    Get Campaign Draft

    Retrieve one campaign draft. Returns Data with ID, Title, Subject, ContactsListID, SegmentationID, SenderEmail, SenderName, Locale, TemplateID and Status.

    Inputs

    draft_idintegerrequired
    Campaign draft ID. Example: 54321
  • mailjet_campaign_draft_status_getGet the sending status of a campaign draft.Read-only

    Get Campaign Draft Status

    Get the sending status of a campaign draft. Returns Data with Status (for example programmed, sent or AXCanceled).

    Inputs

    draft_idintegerrequired
    Campaign draft ID. Example: 54321
  • mailjet_campaign_drafts_listList marketing campaign drafts.Read-only

    List Campaign Drafts

    List marketing campaign drafts. Returns Data, an array with ID, Title, Subject, ContactsListID, SenderEmail, Status, DeliveredAt and CreatedAt.

    Inputs

    campaigninteger
    Retrieves only the campaign draft linked to the specified Campaign ID. Example: 123
    contacts_listinteger
    Retrieves only the campaign drafts linked to the specified contact list ID. Example: 123
    delivered_atstring
    Retrieves only the campaign drafts, which were delivered at the specified timestamp. Both Unix timestamp (e.g. 1514764800) and RFC3339 (2018-01-01T00:00:00) formats are accepted. Example: 2026-11-01T00:00:00
    edit_modestring
    Retrieves only campaign drafts, whose email templates were edited with the specified edit tool. Possible values:; tool2 - Passport drag-and-drop template editor; html2 - HTML editor in Passport; mjml - MJML editor in Passport. Example: tool2
    is_archivedboolean
    When true, will return only archived campaign drafts. When false, archived campaign drafts will be excluded from the response. Example: true
    is_campaignboolean
    Only retrieves campaigndraft resources for which IsCampaign equals the specified value. Example: true
    is_deletedboolean
    When true, will return only deleted campaign drafts. When false, deleted drafts will be excluded from the response. Example: true
    is_handledboolean
    Only retrieves campaigndraft resources for which IsHandled equals the specified value. Example: true
    is_starredboolean
    When true, will return only starred campaign drafts. When false, starred drafts will be excluded from the response. Example: true
    limitinteger
    Number of results per page. Defaults to 10, maximum 1000. Example: 100
    modifiedboolean
    When true, will return only campaign drafts that have been modified after their creation. When false, only non-modified drafts will be returned. Note: All campaign drafts created within the Mailjet app are marked as Modified immediately after creation, while ones created via the API are not. Example: true
    news_letter_templateinteger
    Only retrieves campaigndraft resources for which NewsLetterTemplate equals the specified value. Example: 123
    offsetinteger
    Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
    segmentationinteger
    Retrieves only campaign drafts, which use the specified segmentation ID. Example: 123
    sortstring
    Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC
    statusinteger
    Retrieves only campaign drafts with the specified campaign status ID. Possible values:; -3 - AXCanceled; -2 - Deleted; -1 - Archived; 0 - Draft; 1 - Programmed (scheduled); 2 - Sent; 3 - AXTested (AB Testing versions sent, but winning version not selected yet); 4 - AXSelected (AB Testing winning version selected and sent) Example: -3
    subjectstring
    Retrieves only campaign drafts with the specified Subject line. Example: Hello from Acme
    templateinteger
    Retrieves only campaign drafts which use the specified Template ID. Example: 123
  • mailjet_campaign_getRetrieve one sent campaign by ID.Read-only

    Get Campaign

    Retrieve one sent campaign by ID. Returns Data with ID, Subject, FromEmail, ListID, NewsLetterID, SendStartAt, SendEndAt and Status.

    Inputs

    campaign_idintegerrequired
    Campaign ID, or mj.nl=<newsletter ID>, or the CustomCampaign name. Example: 7654321
  • mailjet_campaign_overview_listList campaigns (newsletters, automation and transactional campaigns) with their send date and headline statistics.Read-only

    List Campaign Overviews

    List campaigns (newsletters, automation and transactional campaigns) with their send date and headline statistics. Returns Data, an array with ID, IDType, Title, Subject, SendTimeStart, DeliveredCount, OpenedCount, ClickedCount and Status.

    Inputs

    allboolean
    When true, will retrieve all campaigns, drafts and AB Testing objects that are not deleted (IsDeleted!=0). When false, both deleted and non-deleted ones will be retrieved. Default value: false Note: You cannot set more than one status query parameter (All, Archived, Drafts, Programmed, Sent, Starred) to True. Example: true
    archivedboolean
    When true, will retrieve all archived campaigns, drafts and AB Testing objects. When false, archived ones are excluded from the response. Default value: false Note: You cannot set more than one status query parameter (All, Archived, Drafts, Programmed, Sent, Starred) to True. Example: true
    draftsboolean
    When true, will retrieve all drafts (and AB Testing objects in Draft mode). When false, both drafts and sent campaigns / AB Testing objects will be retrieved. Default value: false Note: You cannot set more than one status query parameter (All, Archived, Drafts, Programmed, Sent, Starred) to True. Example: true
    idinteger
    Retrieves only the draft, sent campaign or AB testing object linked to this unique numeric ID. Note: Mandatory, when the ID query parameter is used. Example: 123
    id_typestring
    Retrieves only objects of the specified type:; Campaign - Sent campaign; AX - AB Testing object; NL - Draft Note: Mandatory, when the ID query parameter is used. Example: Campaign
    limitinteger
    Number of results per page. Defaults to 10, maximum 1000. Example: 100
    offsetinteger
    Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
    programmedboolean
    When true, will retrieve only drafts that are scheduled for sending - i.e. with Programmed status. When false, both programmed and draft / sent / deleted objects will be retrieved. Default value: false Note: You cannot set more than one status query parameter (All, Archived, Drafts, Programmed, Sent, Starred) to True. Example: true
    sentboolean
    When true, will retrieve only sent campaigns. When false, both sent and not sent objects will be retrieved. Note: You cannot set more than one status query parameter (All, Archived, Drafts, Programmed, Sent, Starred) to True. Example: true
    sortstring
    Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC
    starredboolean
    When true, will retrieve only starred campaigns, drafts and AB Testing objects. When false, both starred and non-starred ones will be retrieved. Default value: false Note: You cannot set more than one status query parameter (All, Archived, Drafts, Programmed, Sent, Starred) to True. Example: true
    subjectstring
    Retrieves only campaigns, drafts and AB Testing objects with the specified subject line. Example: Hello from Acme
  • mailjet_campaigns_listList sent campaigns (marketing and transactional), filtered by sender, list, period or status.Read-only

    List Campaigns

    List sent campaigns (marketing and transactional), filtered by sender, list, period or status. Returns Data, an array with ID, Subject, FromEmail, ListID, NewsLetterID, SendStartAt, SendEndAt, Status and CustomValue.

    Inputs

    campaign_idinteger
    Retrieves only the campaign details for the specified Campaign ID. Example: 123
    contacts_list_idinteger
    Retrieves only details for campaigns sent to the specified Contact List ID. Example: 123
    custom_campaignstring
    Retrieves only details for the campaign with the specified custom value assigned to it. Example: november-newsletter
    fromstring
    Retrieves only details for campaigns, which used the specified sender email address. Example: orders@example.com
    from_domainstring
    Retrieves only details for campaigns, which used the specified sender email domain. Example: example.com
    from_idinteger
    Retrieve only details for campaigns, which used the specified sender ID. Example: 123
    from_tsstring
    Retrieves only details for campaigns sent after the specified timestamp. Both Unix timestamp (e.g. 1514764800) and RFC3339 (2018-01-01T00:00:00) formats are accepted. Example: 2026-11-01T00:00:00Z
    from_typeinteger
    Retrieves only details for campaigns of the specified type:; 1 - Transactional; 2 - Marketing; 3 - Unknown. Example: 1
    is_deletedboolean
    When true, only details for deleted campaigns will be returned. When false, deleted campaigns will be excluded from the response. Example: true
    is_newsletter_toolboolean
    When true, will return only details for campaigns created by the Newsletter tool (legacy template builder). When false, newsletter campaigns will be excluded from the response. Example: true
    is_starredboolean
    When true, will return only details for campaigns marked as starred. When false, starred campaigns will be excluded from the response. Example: true
    limitinteger
    Number of results per page. Defaults to 10, maximum 1000. Example: 100
    offsetinteger
    Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
    periodstring
    Retrieves only details for campaigns sent between the start of the selected period and the current timestamp.; Day - since the start of the current day; Week - since the start of the current week; Month - since the start of the current month; Year - since the start of the current year. Example: 2026-11-01T00:00:00
    sortstring
    Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC
    to_tsstring
    Retrieves only details for campaigns sent before this timestamp. Example: 2026-11-01T00:00:00Z
    workflow_idinteger
    Retrieves only details for campaigns that were triggered by this automation workflow ID. Example: 123
  • mailjet_contact_data_getRetrieve a contact's custom property values (contact data).Read-only

    Get Contact Properties

    Retrieve a contact's custom property values (contact data). Returns Data with ContactID and Data, an array of Name and Value pairs.

    Inputs

    contact_idstringrequired
    Contact ID or email address. Example: jane@example.com
  • mailjet_contact_getRetrieve one contact by ID or email address.Read-only

    Get Contact

    Retrieve one contact by ID or email address. Returns Data with ID, Email, Name, CreatedAt, IsExcludedFromCampaigns, IsOptInPending and LastActivityAt. Use mailjet_contact_data_get for the contact's custom properties.

    Inputs

    contact_idstringrequired
    Contact ID or email address. Example: jane@example.com