Send transactional and marketing email and manage contact lists via the Mailjet API.

Provided free and as is, without warranty of any kind — including merchantability, fitness for a particular purpose, and the accuracy or completeness of any result. See the licence. You are responsible for checking what this produces before relying on it.

Mailjet

Send transactional and marketing email and manage contact lists via the Mailjet API.

A standard-library-only InTouch tool: no requests, no SDK. It calls Mailjet's Send API v3.1 and REST API v3 directly with HTTP Basic auth.

What it does

Operation	Method & endpoint	Purpose
`send-email`	`POST /v3.1/send`	Send a transactional or marketing email
`list-lists`	`GET /v3/REST/contactslist`	List your contact lists
`create-list`	`POST /v3/REST/contactslist`	Create a new contact list
`list-contacts`	`GET /v3/REST/contact`	List contacts (optionally within one list)

Base URLs: https://api.mailjet.com/v3.1 (Send API) and https://api.mailjet.com/v3/REST (REST API).
Body cap: responses are truncated at ~5 MB.

apiKey setup

Mailjet authenticates with HTTP Basic auth using two values: your API Key (public) and your Secret Key (private). The Mailjet curl idiom is --user "$MJ_APIKEY_PUBLIC:$MJ_APIKEY_PRIVATE".

Sign in to the Mailjet dashboard.
Go to Account Settings → API Key Management (REST API).
Copy your API Key and Secret Key.
Pass them to this tool as a single apiKey value joined with a colon: PUBLIC:PRIVATE (e.g. a1b2c3...:9f8e7d...).

Both halves are base64-encoded together into the Authorization: Basic header, so no live OAuth/JWT exchange is needed — a single key string is sufficient.

Sender addresses used in send-email must be validated senders/domains in your Mailjet account, or the API will reject the message.

Inputs

apiKey (required) — PUBLIC:PRIVATE
operation (required) — one of send-email, list-lists, create-list, list-contacts
fromEmail, fromName, to, subject, text, html — for send-email
name — for create-list
contactsList — optional list ID filter for list-contacts
limit, offset — optional pagination for list-lists / list-contacts

Outputs

result — the Mailjet response payload as a JSON string
status — the HTTP status code

Examples

Send a transactional email:

{
  "apiKey": "PUBLIC_KEY:SECRET_KEY",
  "operation": "send-email",
  "fromEmail": "[email protected]",
  "fromName": "Your App",
  "to": "[email protected],[email protected]",
  "subject": "Your receipt",
  "text": "Thanks for your order!",
  "html": "<h3>Thanks for your order!</h3>"
}

List your contact lists:

{
  "apiKey": "PUBLIC_KEY:SECRET_KEY",
  "operation": "list-lists",
  "limit": "20"
}

Create a contact list:

{
  "apiKey": "PUBLIC_KEY:SECRET_KEY",
  "operation": "create-list",
  "name": "newsletter-subscribers"
}

List contacts in a specific list:

{
  "apiKey": "PUBLIC_KEY:SECRET_KEY",
  "operation": "list-contacts",
  "contactsList": "123456",
  "limit": "50"
}

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

error
result
status

Input Properties

Every property this tool accepts, from its own tool.iml.

Property	Type	Required	Default	Description
`apiKey`	string	yes	—	DEPRECATED — bind an API Key credential to the task with `credentialName` instead. A key pasted here is stored in the workflow definition in clear and appears in every export of it. Still honoured for workflows built before the change.
`operation`	string	yes	—	One of: send-email, list-lists, create-list, list-contacts
`fromEmail`	string	no	—	send-email: sender email address (must be a validated Mailjet sender).
`fromName`	string	no	—	send-email: sender display name. Optional.
`to`	string	no	—	send-email: recipient address(es), comma-separated for multiple.
`subject`	string	no	—	send-email: email subject line.
`text`	string	no	—	send-email: plain-text body (TextPart). Provide text and/or html.
`html`	string	no	—	send-email: HTML body (HTMLPart). Provide text and/or html.
`name`	string	no	—	create-list: the name of the contact list to create.
`contactsList`	string	no	—	list-contacts: filter to a single contact list by its numeric ID. Optional.
`limit`	string	no	—	list-lists / list-contacts: max number of items to return (Limit). Optional.
`offset`	string	no	—	list-lists / list-contacts: pagination offset (Offset). Optional.