Mailjet - Atako

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

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.

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 for the grant model and Security for how credentials are protected.