> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Mailjet

> Connect Mailjet to your Atako agents — 9 read and 5 write actions.

Let your agents send transactional emails, manage contacts, contact lists and subscriptions, and read message history, statistics and templates through the Mailjet API.

## Connection

* **Authentication**: API key (API key:Secret key).

<Note>
  Sign in at app.mailjet.com → API → API Key Management → Primary API Key → Generate Secret Key. Mailjet uses two values: the API Key (public) and the Secret Key (private). The secret key is shown only once — copy it right away. Enter the credential as APIKEY:SECRETKEY (the two values joined by a colon).

  See [Mailjet's documentation](https://dev.mailjet.com/email/reference/).
</Note>

## Read actions (9)

| Action                 | Description                                                                                                                                                             |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_api_key_info`     | List the API keys of the account with their settings — the cheapest call to check that the credential works.                                                            |
| `get_contact`          | Retrieve one contact: status, creation and last-activity timestamps. Use list\_contacts or list\_list\_recipients (filtered by ContactEmail) to find the numeric ID.    |
| `get_contact_data`     | Retrieve all contact properties and their values for one contact.                                                                                                       |
| `get_message_history`  | Retrieve the event history of one message — sent, opened, clicked, bounced, spam, unsub — with timestamps.                                                              |
| `list_contact_lists`   | List the contact lists of the account with their subscriber counts. Returns each list numeric ID, needed by manage\_contact\_lists.                                     |
| `list_contacts`        | List contacts of the account. Filter by ContactsList to see the members of one list. Returns each contact numeric ID, needed by the other contact actions.              |
| `list_list_recipients` | List the contact-to-list memberships with their subscription status. Filter by ContactEmail to find the numeric ID of a contact from its email address.                 |
| `list_messages`        | List sent messages with their delivery status. Filter by contact, campaign, custom ID or time window. Returns each message numeric ID, needed by get\_message\_history. |
| `list_templates`       | List the email templates available to the account. Returns each template numeric ID, usable as TemplateID in send\_email.                                               |

## Write actions (5)

| Action                 | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create_contact`       | Create a contact in the global contact list. Email: string, required, must not already exist in the account. Name: string, optional, free-text display name. IsExcludedFromCampaigns: boolean, optional — true adds the contact to the marketing exclusion list. Creating a contact does not subscribe it to any list: call manage\_contact\_lists afterwards.                                                                                                                                                                                                                                                                                                                                 |
| `create_contact_list`  | Create a contact list. Name: string, required, must be unique across the account. The list is created empty — add contacts to it with manage\_contact\_lists.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `manage_contact_lists` | Add, remove or unsubscribe one contact across several contact lists in a single call. contact\_id: string, the numeric contact ID (the contact must already exist). ContactsLists: array of objects, each \{ ListID: integer, Action: one of "addforce" (add and force-subscribe), "addnoforce" (add, keep an existing unsubscribed status), "remove" (remove from the list), "unsub" (keep in the list but unsubscribe) } — NOT an array of list IDs.                                                                                                                                                                                                                                         |
| `send_email`           | Send one transactional email through Send API v3.1. From: object \{ Email: string (required, an activated sender of the account), Name: string }. To: array of objects \{ Email, Name }, at least one. Subject, TextPart, HTMLPart: strings — send TextPart and/or HTMLPart, or a TemplateID instead. TemplateID: integer (bare number, not an object). TemplateLanguage: boolean, set true to interpolate Variables into the template. Variables: object of key/value pairs. Cc, Bcc: arrays of \{ Email, Name }. ReplyTo: object \{ Email, Name }. CustomID: string tag retrievable later with list\_messages. SandboxMode: boolean, true validates the payload without delivering anything. |
| `update_contact_data`  | Replace the contact properties of one contact. contact\_id: string, the numeric contact ID or the contact's email address. Data: array of objects, each \{ Name: string, Value: string } — Name is the property name, which must already exist on the account as a contactmetadata entry. The array replaces the stored properties entirely.                                                                                                                                                                                                                                                                                                                                                   |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.
