> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Mailjet

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.

**Authentication:** API Key and Secret Key
**Categories:** Communication, Marketing
**Tools:** 63: 31 read, 26 write, 6 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=MAILJET)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".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](/agentkit/connections/).

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'mailjet_campaign_draft_get',
  toolInput: {
    draft_id: 54321,
  },
  connector: 'mailjet',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="mailjet_campaign_draft_get",
    tool_input={
        "draft_id": 54321,
    },
    connection_name="mailjet",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `mailjet_campaign_draft_get`

Get Campaign Draft · Read-only

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

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `draft_id` (`integer`, required): Campaign draft ID. Example: 54321

Example input: `{"draft_id":54321}`

### `mailjet_campaign_draft_status_get`

Get Campaign Draft Status · Read-only

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

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `draft_id` (`integer`, required): Campaign draft ID. Example: 54321

Example input: `{"draft_id":54321}`

### `mailjet_campaign_drafts_list`

List Campaign Drafts · Read-only

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

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign` (`integer`, optional): Retrieves only the campaign draft linked to the specified Campaign ID. Example: 123
- `contacts_list` (`integer`, optional): Retrieves only the campaign drafts linked to the specified contact list ID. Example: 123
- `delivered_at` (`string`, optional): 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_mode` (`string`, optional): 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_archived` (`boolean`, optional): When true, will return only archived campaign drafts. When false, archived campaign drafts will be excluded from the response. Example: true
- `is_campaign` (`boolean`, optional): Only retrieves campaigndraft resources for which IsCampaign equals the specified value. Example: true
- `is_deleted` (`boolean`, optional): When true, will return only deleted campaign drafts. When false, deleted drafts will be excluded from the response. Example: true
- `is_handled` (`boolean`, optional): Only retrieves campaigndraft resources for which IsHandled equals the specified value. Example: true
- `is_starred` (`boolean`, optional): When true, will return only starred campaign drafts. When false, starred drafts will be excluded from the response. Example: true
- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `modified` (`boolean`, optional): 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_template` (`integer`, optional): Only retrieves campaigndraft resources for which NewsLetterTemplate equals the specified value. Example: 123
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `segmentation` (`integer`, optional): Retrieves only campaign drafts, which use the specified segmentation ID. Example: 123
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC
- `status` (`integer`, optional): 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
- `subject` (`string`, optional): Retrieves only campaign drafts with the specified Subject line. Example: Hello from Acme
- `template` (`integer`, optional): Retrieves only campaign drafts which use the specified Template ID. Example: 123

Example input: `{}`

### `mailjet_campaign_get`

Get Campaign · Read-only

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

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Campaign ID, or mj.nl=<newsletter ID>, or the CustomCampaign name. Example: 7654321

Example input: `{"campaign_id":7654321}`

### `mailjet_campaign_overview_list`

List Campaign Overviews · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `all` (`boolean`, optional): 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
- `archived` (`boolean`, optional): 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
- `drafts` (`boolean`, optional): 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
- `id` (`integer`, optional): 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_type` (`string`, optional): 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
- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `programmed` (`boolean`, optional): 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
- `sent` (`boolean`, optional): 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
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC
- `starred` (`boolean`, optional): 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
- `subject` (`string`, optional): Retrieves only campaigns, drafts and AB Testing objects with the specified subject line. Example: Hello from Acme

Example input: `{}`

### `mailjet_campaigns_list`

List Campaigns · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, optional): Retrieves only the campaign details for the specified Campaign ID. Example: 123
- `contacts_list_id` (`integer`, optional): Retrieves only details for campaigns sent to the specified Contact List ID. Example: 123
- `custom_campaign` (`string`, optional): Retrieves only details for the campaign with the specified custom value assigned to it. Example: november-newsletter
- `from` (`string`, optional): Retrieves only details for campaigns, which used the specified sender email address. Example: orders@example.com
- `from_domain` (`string`, optional): Retrieves only details for campaigns, which used the specified sender email domain. Example: example.com
- `from_id` (`integer`, optional): Retrieve only details for campaigns, which used the specified sender ID. Example: 123
- `from_ts` (`string`, optional): 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_type` (`integer`, optional): Retrieves only details for campaigns of the specified type:; 1 - Transactional; 2 - Marketing; 3 - Unknown. Example: 1
- `is_deleted` (`boolean`, optional): When true, only details for deleted campaigns will be returned. When false, deleted campaigns will be excluded from the response. Example: true
- `is_newsletter_tool` (`boolean`, optional): 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_starred` (`boolean`, optional): When true, will return only details for campaigns marked as starred. When false, starred campaigns will be excluded from the response. Example: true
- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `period` (`string`, optional): 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
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC
- `to_ts` (`string`, optional): Retrieves only details for campaigns sent before this timestamp. Example: 2026-11-01T00:00:00Z
- `workflow_id` (`integer`, optional): Retrieves only details for campaigns that were triggered by this automation workflow ID. Example: 123

Example input: `{}`

### `mailjet_contact_data_get`

Get Contact Properties · Read-only

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

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): Contact ID or email address. Example: jane@example.com

Example input: `{"contact_id":"<contact_id>"}`

### `mailjet_contact_get`

Get Contact · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): Contact ID or email address. Example: jane@example.com

Example input: `{"contact_id":"<contact_id>"}`

### `mailjet_contact_list_bulk_job_get`

Get Bulk Contact Job · Read-only

Check the status of a bulk contact job started with mailjet_contact_list_bulk_manage.
Returns Data with Status (for example Completed), Count, ErrorFile and JobStart/JobEnd times.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `job_id` (`integer`, required): Job ID returned when the job was started. Example: 987654
- `list_id` (`integer`, required): Contact list ID. Example: 12345

Example input: `{"job_id":987654,"list_id":12345}`

### `mailjet_contact_list_get`

Get Contact List · Read-only

Retrieve one contact list.
Returns Data with ID, Name, Address, SubscriberCount, IsDeleted and CreatedAt.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`integer`, required): Contact list ID. Example: 12345

Example input: `{"list_id":12345}`

### `mailjet_contact_lists_get_for_contact`

Get Contact's Lists · Read-only

List the contact lists one contact belongs to, with its subscription status in each.
Returns Data, an array with ListID, IsUnsub, IsActive and SubscribedAt.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): Contact ID or email address. Example: jane@example.com

Example input: `{"contact_id":"<contact_id>"}`

### `mailjet_contact_lists_list`

List Contact Lists · Read-only

List the contact lists in the account.
Returns Data, an array with ID, Name, Address, SubscriberCount, IsDeleted and CreatedAt, plus Count and Total.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, optional): Retrieves only the contact list with the specified unique address created by Mailjet. This address which can be used only via Mailjet's SMTP server to reach all contacts in it. It is displayed in the Address property of the list. The full email will be {Address}@lists.mailjet.com. Example: orders@example.com
- `exclude_id` (`integer`, optional): Excludes the contact list with specified ID from the response. Example: 123
- `is_deleted` (`boolean`, optional): When true, will retrieve only deleted lists. When false, will retrieve lists that are not deleted. Example: true
- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `name` (`string`, optional): Retrieves only the list with the specified user-selected Name. Example: Newsletter
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC

Example input: `{}`

### `mailjet_contact_properties_list`

List Contact Properties · Read-only

List the custom contact properties (contact metadata) defined in the account.
Returns Data, an array with ID, Name, Datatype (str, int, float, bool, datetime) and NameSpace (static or historic).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `data_type` (`string`, optional): Retrieves only properties with the respective data type:; str - string; int - integer; float - float / number; bool - boolean; datetime - datetime (Unix Timestamp or RFC 3339) Example: 2026-11-01T00:00:00
- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `namespace` (`string`, optional): Retrieves only properties with the respective namespace:; static - Can keep only 1 value. Each change to the value of the property for a contact overwrites the previously selected value. The values are saved in a contactdata object.; historic - Each change to the value of the property creates a record in a new contacthistorydata object, saving the property value and a timestamp of when it was submitted. Example: 2026-11-01T00:00:00
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC

Example input: `{}`

### `mailjet_contact_statistics_list`

List Contact Statistics · Read-only

List per-contact message statistics (delivered, opened, clicked, bounced, spam, unsubscribed counts).
Returns Data, an array with ContactID and the counters, plus Count and Total.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `blocked` (`boolean`, optional): When true, will retrieve statistics only for contacts that have at least one blocked message. When false, contacts with blocked messages will be excluded from the response. Example: true
- `bounced` (`boolean`, optional): When true, will retrieve statistics only for contacts that have at least one bounced message. When false, contacts with bounced messages will be excluded from the response. Example: true
- `click` (`boolean`, optional): When true, will retrieve statistics only for contacts that have at least one message with a registered click. When false, contacts with clicked messages will be excluded from the response. Example: true
- `deferred` (`boolean`, optional): When true, will retrieve statistics only for contacts that have at least one deferred message. When false, contacts with deferred messages will be excluded from the response. Example: true
- `hardbounced` (`boolean`, optional): When true, will retrieve statistics only for contacts that have at least one hard-bounced message. When false, contacts with hard-bounced messages will be excluded from the response. Example: true
- `last_activity_at` (`string`, optional): Retrieves statistics only for contacts, for which LastActivityAt (their last received email, open, click etc.) equals 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
- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `max_last_activity_at` (`string`, optional): Retrieves statistics only for contacts, for which LastActivityAt (their last received email, open, click etc.) is before 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
- `min_last_activity_at` (`string`, optional): Retrieves statistics only for contacts, for which LastActivityAt (their last received email, open, click etc.) is 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:00
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `open` (`boolean`, optional): When true, will retrieve statistics only for contacts that have messages with registered opens. When false, contacts with opened messages will be excluded from the response. Example: true
- `queued` (`boolean`, optional): When true, will retrieve statistics only for contacts that have queued messages. When false, contacts with queued messages will be excluded from the response. Example: true
- `recalculate` (`boolean`, optional): When true, will reload all data from the database. Note: Deprecated for accounts created after April 5th, 2018. Example: true
- `sent` (`boolean`, optional): When true, will retrieve statistics only for contacts that have sent messages. When false, contacts with sent messages will be excluded from the response. Example: true
- `softbounced` (`boolean`, optional): When true, will retrieve statistics only for contacts that have soft-bounced messages. When false, contacts with soft-bounced messages will be excluded from the response. Example: true
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC
- `spam` (`boolean`, optional): When true, will retrieve statistics for only contacts that have messages marked as Spam. When false, contacts with Spam messages will be excluded from the response. Example: true
- `unsubscribed` (`boolean`, optional): When true, will retrieve statistics only for contacts that have unsubscribed from a list at least once. When false, contacts with unsubscribe events will be excluded from the response. Example: true

Example input: `{}`

### `mailjet_contacts_list`

List Contacts · Read-only

List contacts in the account, optionally only those in a contact list or targeted by a campaign.
Returns Data, an array of contacts with ID, Email, Name, CreatedAt, IsExcludedFromCampaigns and DeliveredCount, plus Count and Total.
Use this to browse contacts. Use mailjet_contact_get when you know the ID or email.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign` (`integer`, optional): Retrieves only contacts targeted by this Campaign ID. Example: 123
- `contacts_list` (`integer`, optional): Retrieves only contacts that are part of this Contact List ID. Example: 123
- `is_excluded_from_campaigns` (`boolean`, optional): When true, will retrieve only contacts that have been added to the exclusion list for marketing emails. When false, those contacts will be excluded from the response. Example: true
- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC

Example input: `{}`

### `mailjet_dns_list`

List Sending Domains (DNS) · Read-only

List sending domains with their SPF and DKIM DNS records and status.
Returns Data, an array with ID, Domain, SPFStatus, SPFRecordValue, DKIMStatus, DKIMRecordName, DKIMRecordValue and IsCheckInProgress.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `is_check_in_progress` (`boolean`, optional): When true, will retrieve only DNS records, where a validation check was initiated and is in progress. When false, DNS records where a check is in progress will be excluded from the response. Example: true
- `is_sender_identified` (`boolean`, optional): Retrieves DNS records where IsSenderIdentified matches the specified value. Example: true
- `is_yahoo_fbl` (`boolean`, optional): Retrieves only DNS records where a Yahoo Feedback loop has been setup. Contact the Mailjet Support team to set up the feedback loop. Example: true
- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `max_last_check_at` (`string`, optional): Retrieves only DNS records where the last check was performed before this timestamp. Both Unix timestamp (e.g. 1514764800) and RFC3339 (2018-01-01T00:00:00) formats are accepted. Example: 2026-11-01T00:00:00
- `min_last_check_at` (`string`, optional): Retrieves only DNS records where the last check was performed after this timestamp. Both Unix timestamp (e.g. 1514764800) and RFC3339 (2018-01-01T00:00:00) formats are accepted. Example: 2026-11-01T00:00:00
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC
- `spf_status` (`string`, optional): Retrieves only DNS records where the last domain SPF configuration check resulted in the specified status. Possible values:; OK; Error; Not checked; Not found. Example: OK

Example input: `{}`

### `mailjet_link_click_statistics_list`

List Link Click Statistics · Read-only

List click counts per link for a campaign.
Returns Data, an array with URL, PositionIndex, ClickedMessagesCount and ClickedCount.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Retrieves statistics only for the specified campaign ID. Example: 6000
- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC

Example input: `{"campaign_id":6000}`

### `mailjet_message_get`

Get Message · Read-only

Retrieve one sent message by its ID.
Returns Data with one message: ID, ArrivedAt, Status, ContactID, CampaignID, MessageSize, SpamassassinScore and more.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `message_id` (`integer`, required): Message ID, as returned by mailjet_email_send (MessageID) or mailjet_messages_list. Example: 288230380000000000

Example input: `{"message_id":288230380000000000}`

### `mailjet_message_history_get`

Get Message Event History · Read-only

Retrieve the event history of one message (sent, opened, clicked, bounced, spam, unsub, blocked).
Returns Data, an array of events with EventAt, EventType, State, Useragent and Comment.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `message_id` (`integer`, required): Message ID. Example: 288230380000000000

Example input: `{"message_id":288230380000000000}`

### `mailjet_message_information_list`

List Message Information · Read-only

List sent messages with delivery details (sender, subject, size, spam score, statistics links).
Returns Data, an array with ID, CampaignID, ContactID, SendEndAt, SenderID, SpamAssassinScore, MessageSize and more, plus Count and Total.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, optional): Retrieves information only about messages that are part of this campaign. Example: 123
- `contacts_list` (`integer`, optional): Retrieves information only about messages that were sent to this contact list. Example: 123
- `custom_campaign` (`string`, optional): Retrieves information only about messages that are part of a campaign with the specified Custom ID. Example: november-newsletter
- `from` (`string`, optional): Retrieves information only about messages sent from the specified sender email address. Example: orders@example.com
- `from_domain` (`string`, optional): Retrieves information only about messages sent from the specified sender domain. Example: example.com
- `from_id` (`integer`, optional): Retrieves information only about messages sent from the specified sender ID. Example: 123
- `from_ts` (`string`, optional): Retrieves information only about messages 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_type` (`integer`, optional): Retrieves information only for a specific type of messages:; 1 - Transactional; 2 - Marketing; 3 - Unknown. Example: 1
- `is_deleted` (`boolean`, optional): When true, will retrieve information only for messages that are part of deleted campaigns. When false, messages from deleted campaigns will be excluded from the response. Example: true
- `is_newsletter_tool` (`boolean`, optional): When true, will retrieve information only for campaigns created with the Legacy template builder. When false, campaigns created with the Legacy builder will be excluded from the response. Example: true
- `is_starred` (`boolean`, optional): When true, will retrieve information only for messages that are part of starred campaigns. When false, messages from starred campaigns will be excluded from the response. Example: true
- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `message_status` (`integer`, optional): Retrieves information only for messages with the specified status:; 0 (Processed); 1 (Queued); 2 (Sent); 3 (Opened); 4 (Clicked); 5 (Bounce); 6 (Spam); 7 (Unsub); 8 (Blocked); 9 (SoftBounce); 10 (HardBounce); 11 (Deferred) Example: 0
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `period` (`string`, optional): Retrieves information only for messages 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
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC
- `to_ts` (`string`, optional): Retrieves information only for messages sent before 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

Example input: `{}`

### `mailjet_messages_list`

List Messages · Read-only

List sent messages with their status, filtered by campaign, contact, sender, status or time range.
Returns Data, an array of messages with ID, ArrivedAt, Status, ContactID, CampaignID, Subject (when ShowSubject is set) and more, plus Count and Total.
Use this to find messages. Use mailjet_message_get or mailjet_message_history_get for one message.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign` (`integer`, optional): Retrieves only messages sent as part of the specified Campaign ID. Example: 123
- `contact` (`integer`, optional): Retrieves only messages sent to the specified Contact ID. Example: 123
- `custom_id` (`string`, optional): Retrieves only messages tagged with the specified CustomID. Example: 123
- `destination` (`integer`, optional): Retrieves only messages sent to the specified Destination ID (ID for a specific domain name). Example: 123
- `from_ts` (`string`, optional): Retrieves only messages 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_type` (`integer`, optional): Retrieves only messages of the specified type:; 1 - Transactional; 2 - Marketing; 3 - Unknown. Example: 1
- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `message_state` (`integer`, optional): Retrieves only non-delivered messages with the respective State ID. The MessageState ID explains why a message was not delivered successfully to the recipient:; 1 = user unknown (recipient); 2 = mailbox inactive (recipient); 3 = quota exceeded (recipient); 4 = invalid domain (domain); 5 = no mail host (domain); 6 = relay/access denied (domain); 7 = sender blocked (spam); 8 = content blocked (spam); 9 = policy issue (... Example: 123
- `message_status` (`integer`, optional): Retrieves only messages with the specified status:; 0 (Processed); 1 (Queued); 2 (Sent); 3 (Opened); 4 (Clicked); 5 (Bounce); 6 (Spam); 7 (Unsub); 8 (Blocked); 9 (SoftBounce); 10 (HardBounce); 11 (Deferred) Example: 0
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `plan_subscription` (`integer`, optional): Retrieves only messages with the specified PlanSubscription ID. Example: 123
- `sender_id` (`integer`, optional): Retrieves only messages sent using a sender address with the specified ID. Example: 123
- `show_contact_alt` (`boolean`, optional): When true, the recipient's email address will be displayed in the message object under ContactAlt. Default value: false. Example: true
- `show_custom_id` (`boolean`, optional): When true, the CustomID attached to the message will be displayed in the message object under CustomID. Default value: false. Example: true
- `show_subject` (`boolean`, optional): When true, the subject of the message will be displayed under Subject. Default value: false. Example: true
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ArrivedAt DESC
- `to_ts` (`string`, optional): Retrieves only messages sent before 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

Example input: `{}`

### `mailjet_parse_routes_list`

List Inbound Parse Routes · Read-only

List inbound Parse API routes, which forward email received at a Mailjet address to your webhook.
Returns Data, an array with ID, Email, Url and APIKeyID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC

Example input: `{}`

### `mailjet_recipient_esp_statistics_list`

List Recipient ESP Statistics · Read-only

List statistics for a campaign broken down by recipient email provider (Gmail, Outlook, Yahoo and others).
Returns Data, an array with ESPName and counts such as delivered, opened, clicked and bounced.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`integer`, required): Retrieves statistics only for the specified campaign ID. Example: 6000
- `esp_name` (`integer`, optional): Retrieves statistics for the given ESPs only. Multiple ESPs can be separated with commas. Example: 123
- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC

Example input: `{"campaign_id":6000}`

### `mailjet_segments_list`

List Segments · Read-only

List segments (contact filters) that target contacts by property expressions.
Returns Data, an array with ID, Name, Description, Expression and Status.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `show_deleted` (`boolean`, optional): When true, will retrieve all segments, including deleted ones. When false, will exclude deleted segments from the response. Default value: false. Example: true
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC
- `status` (`string`, optional): Retrieves only segments with the specified status. The status indicates whether a segment is being used for sending or not, or if it was deleted. Possible values:; used; unused; deleted. Example: used

Example input: `{}`

### `mailjet_senders_list`

List Senders · Read-only

List sender addresses and domains registered on the account with their validation status.
Returns Data, an array with ID, Email, Name, Status (Active, Inactive, Deleted), EmailType, IsDefaultSender and DNSID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `dns_id` (`integer`, optional): Retrieves only senders linked to this DNS ID. Example: 123
- `domain` (`string`, optional): Retrieves only senders with the specified domain in their Email. Example: example.com
- `email` (`string`, optional): Retrieves only senders with the specified Email address. Example: jane@example.com
- `is_domain_sender` (`boolean`, optional): When true, will retrieve only domain sender objects. When false, domain senders are excluded from the response. Example: true
- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `local_part` (`string`, optional): Retrieves only senders with the specified local part in their Email address. Since the local part of domains is an asterisk, you can use this query parameter with * as its value to return only sender domains. Example: news
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `show_deleted` (`boolean`, optional): When true, will retrieve deleted sender objects along with non-deleted ones. When false, deleted senders will be excluded from the response. Default value: false. Example: true
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC
- `status` (`string`, optional): Retrieves only senders with the specified status. Possible values:; Inactive; Active; Deleted. Example: Inactive

Example input: `{}`

### `mailjet_stat_counters_get`

Get Statistics Counters · Read-only

Get message counts (processed, delivered, opened, clicked, bounced, spam, unsubscribed and more) for the API key, a campaign or a contact list, over time or as a total.
Returns Data, an array of counter objects with MessageSentCount, MessageDeliveredCount, MessageOpenedCount, MessageClickedCount, MessageHardBouncedCount and more, one per time slice.
Use this for aggregate statistics. Use mailjet_campaign_overview_list for per-campaign summaries.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `counter_resolution` (`string`, required): Defines the timescale of aggregation for your statistics. Possible values:; Highest (5-minute intervals); Hour; Day; Lifetime : cannot be used with CounterTiming=Event. Example: Lifetime
- `counter_source` (`string`, required): Defines the scope of aggregation for your statistics. Possible values:; Campaign; APIKey; List : Contact list. Can only be used with CounterTiming=Message&CounterResolution=Lifetime.; Sender : Sender email address. Can only be used with CounterTiming=Message. Example: Campaign
- `counter_timing` (`string`, required): Defines the reference timestamp for aggregation of statistics. More information Possible values:; Message; Event Note: If you select CounterTiming=Event, you will not be able to choose CounterResolution=Lifetime, as retrieving statistics with event-based timings needs a specific timescale to illustrate the evolution of the stats. Example: Message
- `from_ts` (`string`, optional): Retrieve statistics for messages sent after the specified timestamp. Mandatory when CounterResolution is different from Lifetime. Both Unix timestamp (e.g. 1514764800) and RFC3339 (2018-01-01T00:00:00) formats are accepted. Note: The maximum time period that can be selected between FromTSand ToTS equals 100 times the timescale selected for CounterResolution. Example: 2026-11-01T00:00:00Z
- `source_id` (`integer`, optional): List of either Campaign IDs or ContactsList IDs (separated by commas). Mandatory when CounterSource indicates Campaign, List or Sender. Example: 0
- `to_ts` (`string`, optional): Retrieve statistics for messages sent before the specified timestamp. Both Unix timestamp (e.g. 1514764800) and RFC3339 (2018-01-01T00:00:00) formats are accepted. Note: The maximum time period that can be selected between FromTSand ToTS equals 100 times the timescale selected for CounterResolution. Example: 2026-11-01T00:00:00Z

Example input: `{"counter_resolution":"<counter_resolution>","counter_source":"<counter_source>","counter_timing":"<counter_timing>"}`

### `mailjet_template_content_get`

Get Template Content · Read-only

Retrieve a template's content: HTML part, text part, MJML and headers (Subject, From, Reply-To).
Returns Data with Html-part, Text-part, MJMLContent and Headers.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `template_id` (`integer`, required): Template ID. Example: 1234567

Example input: `{"template_id":1234567}`

### `mailjet_template_get`

Get Template · Read-only

Retrieve one template's settings.
Returns Data with ID, Name, Description, Purposes, EditMode, Locale, Categories and Author.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `template_id` (`integer`, required): Template ID. Example: 1234567

Example input: `{"template_id":1234567}`

### `mailjet_templates_list`

List Templates · Read-only

List email templates owned by the account (and optionally Mailjet's shared templates).
Returns Data, an array with ID, Name, Description, Purposes, EditMode, OwnerType, Locale and CreatedAt.
Use mailjet_template_content_get for a template's HTML and text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `categories` (`string`, optional): Retrieves information only about templates, which have the respective categories assigned. You can separate multiple categories with a comma. When selecting multiple categories, use the CategoriesSelectionMethod to specify the relation between between the selected ones and the template's list of categories. Example: newsletter
- `categories_selection_method` (`string`, optional): Describes the relation between the value of the Categories query parameter and the template's list of categories. Possible values:; containsany; containsall; issubset Default value: containsany. Example: containsany
- `edit_mode` (`integer`, optional): Retrieves information only about templates with the specified mode of editing:; 1 - Passport drag-and-drop builder; 2 - Passport HTML builder; 3 - Passport Saved Section (snippet) builder; 4 - Passport MJML builder. Example: 1
- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `name` (`string`, optional): Retrieves information only about templates with the specified name. Example: Newsletter
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `owner_type` (`string`, optional): Retrieves information only about templates with the specified owner type. Possible values:; apikey - Templates and their content can be retrieved, edited and used only by the API Key they were created from.; user - Templates created by the Primary API Key. Templates and their content can be retrieved by the Primary API Key, as well as all subaccount API Keys. Example: apikey
- `purposes` (`string`, optional): Retrieves information only about templates, which have the respective purposes assigned. You can separate multiple purposes with a comma. When selecting multiple purposes, use the PurposesSelectionMethod to specify the relation between between the selected ones and the template's list of purposes. Possible values:; marketing; transactional; automation. Example: marketing
- `purposes_selection_method` (`string`, optional): Describes the relation between the value of the Purposes query parameter and the template's list of purposes. Possible values:; containsany; containsall; issubset. Example: containsany
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC

Example input: `{}`

### `mailjet_webhook_get`

Get Event Webhook · Read-only

Retrieve one event webhook by ID.
Returns Data with ID, EventType, Url, Status, IsBackup and Version.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `url_id` (`integer`, required): Event webhook ID, or the event type (for example open) Example: 123

Example input: `{"url_id":123}`

### `mailjet_webhooks_list`

List Event Webhooks · Read-only

List the event webhook URLs (event callback URLs) configured on the API key.
Returns Data, an array with ID, EventType, Url, Status, IsBackup and Version.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `backup` (`boolean`, optional): When true, will retrieve only backup callback URLs. When false, backup callback URLs will be excluded from the response. Example: true
- `event_type` (`integer`, optional): Retrieves only callback URL objects linked to the specified event type:; 1 - click; 2 - bounce; 3 - spam; 4 - blocked; 5 - unsubscribe; 6 - open; 7 - sent. Example: 1
- `limit` (`integer`, optional): Number of results per page. Defaults to 10, maximum 1000. Example: 100
- `offset` (`integer`, optional): Index of the first result to return, for paging (for example 100 with limit 100 returns results 101-200) Example: 0
- `sort` (`string`, optional): Sort by a property, optionally followed by a space and DESC (ascending by default). Not every property is sortable. Example: ID DESC
- `status` (`string`, optional): Retrieves only callback URL objects with the specified status. Example: alive
- `version` (`integer`, optional): Retrieves only callback URL objects with the specified Version. Possible values:; 1 - The events are not grouped and a callback is received for each event individually.; 2 - The events are grouped. A callback for the grouped events is received with a maximum frequency of once per second. Important to use to avoid reaching API rate limits. Example: 1

Example input: `{}`

### `mailjet_campaign_draft_content_set`

Set Campaign Draft Content · Write

Set a campaign draft's HTML part, text part, MJML and headers.
Returns Data with the saved content.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `draft_id` (`integer`, required): Campaign draft ID. Example: 54321
- `headers` (`object`, optional): Headers for the campaign, such as Subject and Reply-To. Example: {"Subject": "November news"}
- `html_part` (`string`, optional): The HTML-formatted part of the message. Example: <h3>Dear passenger, welcome to Mailjet!</h3><br />May the delivery force be with you!
- `mjml_content` (`string`, optional): The content of the message in MJML. Note: Any update of the MJMLContent property of the /campaigndraft/{draft_ID}/detailcontent resource will not automatically generate the Html-part version of the content. In this case, you should regenerate the Html-part with the MJML tools. Example: <mjml><mj-body><mj-text>Hello</mj-text></mj-body></mjml>
- `text_part` (`string`, optional): The plain text part of the message. Example: Dear passenger, welcome to Mailjet! May the delivery force be with you!

Example input: `{"draft_id":54321}`

### `mailjet_campaign_draft_create`

Create Campaign Draft · Write

Create a marketing campaign draft addressed to a contact list (optionally a segment).
Returns Data with the draft's ID. Next set its content with mailjet_campaign_draft_content_set, then test, schedule or send it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `locale` (`string`, required): Locale, in which the information is saved. Example: en_US
- `subject` (`string`, required): Subject line for the campaign emails. Example: Your email flight plan!
- `contacts_list_alt` (`string`, optional): A unique contact list email address generated by Mailjet, which is linked to this campaign draft. Required for successful sending of the campaign. Interchangeable with ContactsListID. Example: abcdef123
- `contacts_list_id` (`integer`, optional): Unique numeric ID for the contact list linked to this draft. Required for successful sending of the campaign. Interchangeable with ContactsListAlt. Example: 123456
- `edit_mode` (`string`, optional): Edit mode for the campaign draft. Possible values:; tool2 - Passport drag-and-drop template editor; html2 - HTML editor in Passport; mjml - MJML editor in Passport. Example: tool2
- `is_starred` (`boolean`, optional): Indicates whether the campaign draft is marked as Starred or not. Example: false
- `is_text_part_included` (`boolean`, optional): Indicates whether the draft email contains a text version or not. Example: true
- `reply_email` (`string`, optional): Reply-to email address for the campaign. Returned only if a reply-to email was specified. Example: replyto@mailjet.com
- `segmentation_alt` (`string`, optional): The user-selected name of the segment configuration (contactfilter) used for this campaign draft. Interchangeable with SegmentationID. Example: Customers under 35
- `segmentation_id` (`integer`, optional): ID of the segment configuration (contactfilter) used for this campaign draft. Interchangeable with SegmentationAlt. Example: 123
- `sender` (`string`, optional): ID of the sender email address. Required for successful sending of the campaign. Example: 1234
- `sender_email` (`string`, optional): The email address of the sender. Required for successful sending of the campaign. Example: pilot@mailjet.com
- `sender_name` (`string`, optional): Name of the sender, which will be visible to recipients. Example: Your Mailjet Pilot
- `template_id` (`integer`, optional): Unique numeric ID of the template the CampaignDraft was generated from, or as which it was last saved. Changing the template ID will not update the content of the CampaignDraft. Example: 123456
- `title` (`string`, optional): Internal title for this campaign draft. Example: My Mailjet Campaign

Example input: `{"locale":"<locale>","subject":"<subject>"}`

### `mailjet_campaign_draft_schedule`

Schedule Campaign Draft · Write

Schedule a campaign draft to be sent to its contact list at a given time.
Returns Data with Date and Status. Cancel with mailjet_campaign_draft_schedule_delete.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `date` (`string`, required): Send time in ISO 8601 (RFC 3339) format. Example: 2026-11-20T09:00:00Z
- `draft_id` (`integer`, required): Campaign draft ID. Example: 54321

Example input: `{"date":"<date>","draft_id":54321}`

### `mailjet_campaign_draft_send`

Send Campaign Draft Now · Write

Send a campaign draft to its contact list immediately.
Returns Data with Status. Track it with mailjet_campaign_draft_status_get.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `draft_id` (`integer`, required): Campaign draft ID. Example: 54321

Example input: `{"draft_id":54321}`

### `mailjet_campaign_draft_test`

Send Campaign Draft Test · Write

Send a test copy of a campaign draft to up to a few addresses.
Returns Data with the test Status.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `draft_id` (`integer`, required): Campaign draft ID. Example: 54321
- `recipients` (`array`, required): Test recipients, each an object with Email and optional Name. Example: [{"Email": "qa@example.com", "Name": "QA"}]

Example input: `{"draft_id":54321,"recipients":[{"Email":"qa@example.com","Name":"QA"}]}`

### `mailjet_campaign_draft_update`

Update Campaign Draft · Write

Change a campaign draft's title, subject, list, segment, sender or locale.
Returns Data with the updated draft.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `draft_id` (`integer`, required): Campaign draft ID. Example: 54321
- `contacts_list_id` (`integer`, optional): Unique numeric ID for the contact list linked to this draft. Required for successful sending of the campaign. Example: 123456
- `edit_mode` (`string`, optional): Edit mode for the campaign draft. Possible values:; tool2 - Passport drag-and-drop template editor; html2 - HTML editor in Passport; mjml - MJML editor in Passport. Example: tool2
- `is_starred` (`boolean`, optional): Indicates whether the campaign draft is marked as Starred or not. Example: false
- `is_text_part_included` (`boolean`, optional): Indicates whether the draft email contains a text version or not. Example: true
- `locale` (`string`, optional): Locale, in which the information is saved. Example: en_US
- `reply_email` (`string`, optional): Reply-to email address for the campaign. Returned only if a reply-to email was specified. Example: replyto@mailjet.com
- `segmentation_alt` (`string`, optional): The user-selected name of the segment configuration (contactfilter) used for this campaign draft. Interchangeable with SegmentationID. Example: Customers under 35
- `segmentation_id` (`integer`, optional): ID of the segment configuration (contactfilter) used for this campaign draft. Interchangeable with SegmentationAlt. Example: 123
- `sender` (`string`, optional): ID of the sender email address. Required for successful sending of the campaign. Example: 1234
- `sender_email` (`string`, optional): The email address of the sender. Required for successful sending of the campaign. Example: pilot@mailjet.com
- `sender_name` (`string`, optional): Name of the sender, which will be visible to recipients. Example: Your Mailjet Pilot
- `status` (`string`, optional): The status of this campaign draft. You can only modify its value only if the status is Draft (0, can be changed to -1 or -2) or Archived (-1, can be changed to -2 or 0). Example: -1
- `subject` (`string`, optional): Subject line for the campaign emails. Example: Your email flight plan!
- `template_id` (`integer`, optional): Unique numeric ID of the template the CampaignDraft was generated from, or as which it was last saved. Changing the template ID will not update the content of the CampaignDraft. Example: 123456
- `title` (`string`, optional): Internal title for this campaign draft. Example: My Mailjet Campaign

Example input: `{"draft_id":54321}`

### `mailjet_contact_create`

Create Contact · Write

Create a contact in the account's global contact list.
Returns Data with the new contact's ID, Email and Name. To add it to a list, use mailjet_contact_list_manage_contact or mailjet_contact_lists_manage.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email` (`string`, required): Contact email address. Must be unique (not present already in the global contact list). Example: passenger@mailjet.com
- `is_excluded_from_campaigns` (`boolean`, optional): Indicates whether the contact is added to the exclusion list for campaigns or not. An excluded contact will not be receiving any marketing emails. Example: false
- `name` (`string`, optional): User-selected name for this contact. Example: New Contact

Example input: `{"email":"<email>"}`

### `mailjet_contact_data_update`

Update Contact Properties · Write

Set custom property values on a contact. Properties must exist first (see mailjet_contact_properties_list).
Returns Data with ContactID and the updated Data array.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): Contact ID or email address. Example: jane@example.com
- `data` (`array`, optional): Property values to set, each an object with Name (an existing contact property) and Value. Example: [{"Name": "first_name", "Value": "Jane"}]

Example input: `{"contact_id":"<contact_id>"}`

### `mailjet_contact_list_bulk_manage`

Bulk Manage Contacts in List · Write

Start an asynchronous job that adds, subscribes, unsubscribes or removes many contacts in one contact list.
Returns Data with the JobID; check progress with mailjet_contact_list_bulk_job_get.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `action` (`string`, required): Action to be performed on the contacts for this list:; addforce - Add the contacts to this list and subscribe all of them. If the contact is already present in the list as unsubscribed, it will be forcibly subscribed once again.; addnoforce - Add the contacts to this list and subscribe them to it. If the contact is already present, it will retain its subscription status, i.e. Example: addnoforce
- `contacts` (`array`, required): Contacts to process, each an object with Email and optional Name, IsExcludedFromCampaigns and Properties. Example: [{"Email": "jane@example.com", "Name": "Jane"}]
- `list_id` (`integer`, required): Contact list ID. Example: 12345

Example input: `{"action":"<action>","contacts":[{"Email":"jane@example.com","Name":"Jane"}],"list_id":12345}`

### `mailjet_contact_list_create`

Create Contact List · Write

Create a contact list.
Returns Data with the new list's ID, Name and Address.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): User-specified name for this contact list (must be unique). Example: my_contactslist
- `is_deleted` (`boolean`, optional): When true, the contact list will be marked as Deleted. Deleted lists can later be reinstated by updating this value to False. Example: false

Example input: `{"name":"<name>"}`

### `mailjet_contact_list_manage_contact`

Add or Remove Contact in List · Write

Add, subscribe, unsubscribe or remove one contact in a contact list, creating the contact if needed.
Returns Data with ContactID, Email, Action, Name and Properties.
Use mailjet_contact_list_bulk_manage for many contacts.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `action` (`string`, required): Action to be performed on the contact for this list:; addforce - Add the contact to this list and subscribe all of them. If the contact is already present in the list as unsubscribed, it will be forcibly subscribed once again.; addnoforce - Add the contact to this list and subscribe them to it. If the contact is already present, it will retain its subscription status, i.e. Example: addnoforce
- `email` (`string`, required): The email address of this contact. Example: passenger@mailjet.com
- `list_id` (`integer`, required): Contact list ID. Example: 12345
- `name` (`string`, optional): User-defined name for the contact. Example: John Smith
- `properties` (`object`, optional): A JSON object containing contact properties and their values. Each property is listed with its name as the parameter name, and the property value as the parameter value. The properties must have been created beforehand. Example: {"Name": "John Smith", "Age": 30}

Example input: `{"action":"<action>","email":"<email>","list_id":12345}`

### `mailjet_contact_list_update`

Update Contact List · Write

Rename a contact list or change its deleted flag.
Returns Data with the updated list.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`integer`, required): Contact list ID. Example: 12345
- `is_deleted` (`boolean`, optional): When true, the contact list will be marked as Deleted. Deleted lists can later be reinstated by updating this value to False. Example: false
- `name` (`string`, optional): User-specified name for this contact list (must be unique). Example: my_contactslist

Example input: `{"list_id":12345}`

### `mailjet_contact_lists_manage`

Manage Contact's Lists · Write

Add, subscribe, unsubscribe or remove one existing contact across several contact lists in one call.
Returns Data with the ContactsLists actions applied.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `contact_id` (`string`, required): Contact ID or email address. Example: jane@example.com
- `contacts_lists` (`array`, required): List actions, each an object with ListID and Action (addforce, addnoforce, remove or unsub) Example: [{"ListID": 12345, "Action": "addnoforce"}]

Example input: `{"contact_id":"<contact_id>","contacts_lists":[{"ListID":12345,"Action":"addnoforce"}]}`

### `mailjet_contact_property_create`

Create Contact Property · Write

Define a new custom contact property that contacts can hold values for.
Returns Data with the property's ID, Name, Datatype and NameSpace.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the contact property. The name must be unique for the respective namespace. Example: first_name
- `datatype` (`string`, optional): Indicates the type of data accepted for this contact property:; str - string; int - integer; float - float / number; bool - boolean; datetime - datetime (Unix Timestamp or RFC 3339) Default value: str. Example: str
- `name_space` (`string`, optional): Indicates the namespace of this contact property:; static - Can keep only 1 value. Each change to the value of the property for a contact overwrites the previously selected value. The values are saved in a contactdata object.; historic - Each change to the value of the property creates a record in a new contacthistorydata object, saving the property value and a timestamp of when it was submitted. Example: static

Example input: `{"name":"<name>"}`

### `mailjet_contact_update`

Update Contact · Write

Change a contact's name or campaign exclusion flag.
Returns Data with the updated contact.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): Contact ID or email address. Example: jane@example.com
- `is_excluded_from_campaigns` (`boolean`, optional): Indicates whether the contact is added to the exclusion list for campaigns or not. An excluded contact will not be receiving any marketing emails. Example: false
- `name` (`string`, optional): User-selected name for this contact. Example: New Contact

Example input: `{"contact_id":"<contact_id>"}`

### `mailjet_dns_check`

Check Domain DNS · Write

Re-check a sending domain's SPF and DKIM records now.
Returns Data with DKIMStatus, SPFStatus, DKIMErrors, SPFErrors and the records found.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `dns_id` (`string`, required): DNS (domain) ID from mailjet_dns_list, or the domain name. Example: example.com

Example input: `{"dns_id":"<dns_id>"}`

### `mailjet_email_send`

Send Email · Write

Send one email (from the simple inputs) or a batch of up to 50 messages (messages) with the Mailjet Send API v3.1.
Returns Messages, one result per message with Status and, per recipient, Email, MessageID, MessageUUID and MessageHref (or Errors).
Use this to send transactional email. Use mailjet_campaign_draft_send for a marketing campaign to a contact list.
Prerequisite: the sender address must be a validated sender or domain (see mailjet_senders_list).

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `advance_error_handling` (`boolean`, optional): Enable stricter payload checks. Example: false
- `attachments` (`array`, optional): Attachments, each with ContentType, Filename and Base64Content (the file as base64). Total message size is limited to 15 MB. Example: [{"ContentType": "application/pdf", "Filename": "invoice.pdf", "Base64Content": "JVBERi0xLjQK"}]
- `bcc` (`array`, optional): BCC recipients, each with Email and optional Name. Example: [{"Email": "audit@example.com"}]
- `cc` (`array`, optional): CC recipients, each with Email and optional Name. Example: [{"Email": "boss@example.com"}]
- `custom_campaign` (`string`, optional): Campaign name to group these messages in statistics. Example: order-notifications
- `custom_id` (`string`, optional): Your own ID for the message (up to 64 characters), returned in events. Example: order-A1001
- `deduplicate_campaign` (`boolean`, optional): Do not send the same custom_campaign to a contact twice. Example: false
- `event_payload` (`string`, optional): Payload returned in event webhooks for this message. Example: {"order":"A1001"}
- `from_email` (`string`, optional): Sender email address. Must be validated in Mailjet. Required unless messages is set. Example: orders@example.com
- `from_name` (`string`, optional): Sender display name. Example: Acme Orders
- `globals` (`object`, optional): Properties applied to every message in the call (any message property except To) Example: {"CustomCampaign": "november-receipts"}
- `headers` (`object`, optional): Extra email headers, as an object of header name to value. Example: {"X-Order-ID": "A1001"}
- `html_part` (`string`, optional): HTML body. Provide text_part, html_part or template_id. Example: <h3>Hi Jane</h3>Your order is on its way.

- `inlined_attachments` (`array`, optional): Inline images, each with ContentType, Filename, ContentID and Base64Content; reference them in HTML as cid:ContentID. Example: [{"ContentType": "image/png", "Filename": "logo.png", "ContentID": "logo", "Base64Content": "iVBORw0KGgo="}]
- `messages` (`array`, optional): Full Send API v3.1 message objects for a batch (up to 50), each with From, To and content fields such as Subject, TextPart, HTMLPart or TemplateID. When set, the single-message inputs above are ignored. Example: [{"From": {"Email": "orders@example.com"}, "To": [{"Email": "jane@example.com"}], "Subject": "Hi", "TextPart": "Hello"}]
- `priority` (`integer`, optional): Processing priority in your account's queue, 0 (lowest) to 3 (highest) Example: 2
- `reply_to_email` (`string`, optional): Reply-To address. Example: help@example.com
- `sandbox_mode` (`boolean`, optional): Validate the request without delivering anything. Example: false
- `subject` (`string`, optional): Subject line. Example: Your order has shipped
- `template_id` (`integer`, optional): ID of a Mailjet template to use as the content (see mailjet_templates_list) Example: 1234567
- `template_language` (`boolean`, optional): Process the Mailjet template language in the content (needed for variables) Example: true
- `text_part` (`string`, optional): Plain-text body. Provide text_part, html_part or template_id. Example: Hi Jane, your order is on its way.
- `to` (`array`, optional): Recipients, each an object with Email and an optional Name. Required unless messages is set. Example: [{"Email": "jane@example.com", "Name": "Jane Doe"}]
- `track_clicks` (`string`, optional): Click tracking for this message. Example: enabled. One of: `account_default`, `disabled`, `enabled`.
- `track_opens` (`string`, optional): Open tracking for this message. Example: enabled. One of: `account_default`, `disabled`, `enabled`.
- `url_tags` (`string`, optional): Query string appended to every link, without the leading ? Example: utm_source=mailjet&utm_medium=email
- `variables` (`object`, optional): Template language variables for this message, as an object of name to value. Example: {"first_name": "Jane", "order_id": "A1001"}

Example input: `{}`

### `mailjet_parse_route_create`

Create Inbound Parse Route · Write

Create an inbound route: email sent to the route's address is parsed and POSTed as JSON to your URL.
Returns Data with the route's ID, Email (the receiving address, generated when not given) and Url.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `url` (`string`, required): The webhook URL, where you want to receive the parsed email information. Note: The URL provided cannot be a root URL. Example: https://www.example.com/123/
- `api_key_id` (`integer`, optional): Unique numeric API Key ID to whom this object belongs. Example: 123456
- `email` (`string`, optional): The email address you want to use. Emails sent to this address will be parsed and the information passed on to the webhook URL in JSON format. If not selected, an email address will automatically be generated by Mailjet. Example: parseroute@example.com

Example input: `{"url":"<url>"}`

### `mailjet_segment_create`

Create Segment · Write

Create a segment (contact filter) from an expression over contact properties, for use as a campaign's SegmentationID.
Returns Data with the segment's ID, Name and Expression.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `expression` (`string`, required): The rule, based on which the segment is calculated. Refer to our Segmentation Guide for detailed information on the syntax. Example: (age<35)
- `name` (`string`, required): User-selected name for this segment. Example: Customers under 35
- `description` (`string`, optional): A description of the segment you can add for convenience, or to easier understand its functionality. Example: Will send only to contacts under 35 years of age.

Example input: `{"expression":"<expression>","name":"<name>"}`

### `mailjet_sender_create`

Create Sender · Write

Register a sender address (or *@domain) so you can send from it. Mailjet emails a validation link.
Returns Data with the sender's ID and Status. Then validate with mailjet_sender_validate.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email` (`string`, required): The email address or domain for this sender. Example: pilot@mailjet.com
- `email_type` (`string`, optional): Type of emails this sender will send. This is for purely informative purposes - the values do not place any sending restrictions on the sender email or domain.; transactional - transactional emails; bulk - campaign emails; unknown - both. Example: bulk
- `is_default_sender` (`boolean`, optional): Indicates whether this is the default sender or not. Example: false
- `name` (`string`, optional): User-provided name for this sender. Example: Marketing sender

Example input: `{"email":"<email>"}`

### `mailjet_sender_validate`

Validate Sender · Write

Check whether a sender's domain DNS or validation email is complete and activate it.
Returns Data with ValidationMethod and Errors, or Status when already validated.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `sender_id` (`integer`, required): Sender ID. Example: 56789

Example input: `{"sender_id":56789}`

### `mailjet_template_content_set`

Set Template Content · Write

Set a template's content: HTML part, text part, MJML and headers. Replaces the existing content.
Returns Data with the saved content.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `template_id` (`integer`, required): Template ID. Example: 1234567
- `headers` (`object`, optional): Default headers for the template, such as Subject, From ("Name <email>") and Reply-To. Example: {"Subject": "Your order {{var:order_id}}", "From": "Acme <orders@example.com>"}
- `html_part` (`string`, optional): The HTML-formatted content of the template with Mustache-like logic. Example: <h3>Dear passenger, welcome to Mailjet!</h3><br />May the delivery force be with you!
- `mjml_content` (`string`, optional): The content of the template in MJML. Example: <mjml><mj-body><mj-text>Hello</mj-text></mj-body></mjml>
- `text_part` (`string`, optional): The plain text content of the template with Mustache-like logic. Example: Dear passenger, welcome to Mailjet! May the delivery force be with you!

Example input: `{"template_id":1234567}`

### `mailjet_template_create`

Create Template · Write

Create a template record. Add its HTML and text with mailjet_template_content_set.
Returns Data with the template's ID and settings.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Internal name for this template. Example: Promo Codes
- `author` (`string`, optional): The name of the template author. Example: John Doe
- `categories` (`string`, optional): An array containing a list of strings indicating the categories, to which the template is associated. Accepted values are full, basic, newsletter, e-commerce, events, travel, sports, welcome, contact-property-update, support, invoice, anniversary, account, activation. Example: array
- `copyright` (`string`, optional): The Copyright message. Example: Mailjet
- `description` (`string`, optional): Free text used as a description for this template. Example: Used to send out promo codes.
- `edit_mode` (`integer`, optional): Edit mode for this template:; 1 - Passport drag-and-drop builder; 2 - Passport HTML builder; 3 - Passport Saved Section (snippet) builder; 4 - Passport MJML builder When a template is created through the API, the value has to be set by the caller - there is no fallback. Templates created in the Mailjet app are always 1 - Passport drag-and-drop builder. Example: 1
- `is_starred` (`boolean`, optional): Indicates whether this campaign is marked as starred or not. Default value: false. Example: false
- `is_text_part_generation_enabled` (`boolean`, optional): Indicates whether the generation of a text version of the template will be enabled or not. Default value: false. Example: true
- `locale` (`string`, optional): The locale for this template (AnsiString). Default value: en_US. Example: en_US
- `owner_type` (`string`, optional): Indicates the type of the template owner. Possible values:; apikey - Templates and their content can be retrieved, edited and used only by the API Key they were created from.; user - Templates created by the Primary API Key. Templates and their content can be retrieved by the Primary API Key, as well as all subaccount API Keys. Example: user
- `presets` (`string`, optional): A JSON string containing the different pre-defined styles for this template. Example: string
- `purposes` (`array`, optional): An array indicating whether the template is a marketing, transactional or automation one. Upon POST request only the first value in the array is taken into account. Possible values:; marketing; transactional; automation If no value is set, the template will not be visible in the Mailjet app, as there is no tab under which to display it. Example: ["transactional"]

Example input: `{"name":"<name>"}`

### `mailjet_template_update`

Update Template · Write

Change a template's name, description, purposes, locale or categories.
Returns Data with the updated template.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `template_id` (`integer`, required): Template ID. Example: 1234567
- `author` (`string`, optional): The name of the template author. Example: John Doe
- `categories` (`string`, optional): An array containing a list of strings indicating the categories, to which the template is associated. Accepted values are full, basic, newsletter, e-commerce, events, travel, sports, welcome, contact-property-update, support, invoice, anniversary, account, activation. Example: array
- `copyright` (`string`, optional): The Copyright message. Example: Mailjet
- `description` (`string`, optional): Free text used as a description for this template. Example: Used to send out promo codes.
- `edit_mode` (`integer`, optional): Edit mode for this template:; 1 - Passport drag-and-drop builder; 2 - Passport HTML builder; 3 - Passport Saved Section (snippet) builder; 4 - Passport MJML builder When a template is created through the API, the value has to be set by the caller - there is no fallback. Templates created in the Mailjet app are always 1 - Passport drag-and-drop builder. Example: 1
- `is_starred` (`boolean`, optional): Indicates whether this campaign is marked as starred or not. Default value: false. Example: false
- `is_text_part_generation_enabled` (`boolean`, optional): Indicates whether the generation of a text version of the template will be enabled or not. Default value: false. Example: true
- `locale` (`string`, optional): The locale for this template (AnsiString). Default value: en_US. Example: en_US
- `name` (`string`, optional): Internal name for this template. Example: Promo Codes
- `owner_type` (`string`, optional): Indicates the type of the template owner. Possible values:; apikey - Templates and their content can be retrieved, edited and used only by the API Key they were created from.; user - Templates created by the Primary API Key. Templates and their content can be retrieved by the Primary API Key, as well as all subaccount API Keys. Example: user
- `presets` (`string`, optional): A JSON string containing the different pre-defined styles for this template. Example: string
- `purposes` (`array`, optional): An array indicating whether the template is a marketing, transactional or automation one. Upon POST request only the first value in the array is taken into account. Possible values:; marketing; transactional; automation If no value is set, the template will not be visible in the Mailjet app, as there is no tab under which to display it. Example: ["transactional"]

Example input: `{"template_id":1234567}`

### `mailjet_webhook_create`

Create Event Webhook · Write

Register a URL that Mailjet POSTs events of one type to (sent, open, click, bounce, spam, blocked, unsub).
Returns Data with the new webhook's ID, EventType, Url and Status.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `url` (`string`, required): The URL used for this object. Note: The URL provided cannot be a root URL. Example: https://www.example.com/123/
- `event_type` (`string`, optional): The type of event that is being tracked. Possible values:; open; click; bounce; spam; blocked; unsub; sent Default value: open. Example: open
- `is_backup` (`boolean`, optional): Indicates whether this is a backup URL or not. The backup URL will be used in case the primary one is suspended. Example: false
- `status` (`string`, optional): Defines whether the callback URL is active or not. Possible values:; dead; alive. Example: alive

Example input: `{"url":"<url>"}`

### `mailjet_webhook_update`

Update Event Webhook · Write

Change an event webhook's URL, event type, status or backup flag.
Returns Data with the updated webhook.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `url_id` (`integer`, required): Event webhook ID. Example: 123
- `event_type` (`string`, optional): The type of event that is being tracked. Possible values:; open; click; bounce; spam; blocked; unsub; sent Default value: open. Example: open
- `is_backup` (`boolean`, optional): Indicates whether this is a backup URL or not. The backup URL will be used in case the primary one is suspended. Example: false
- `status` (`string`, optional): Defines whether the callback URL is active or not. Possible values:; dead; alive. Example: alive
- `url` (`string`, optional): The URL used for this object. Note: The URL provided cannot be a root URL. Example: https://www.example.com/123/

Example input: `{"url_id":123}`

### `mailjet_campaign_draft_schedule_delete`

Cancel Campaign Schedule · Destructive

Cancel a campaign draft's scheduled send; the draft stays.
Returns no content (204).

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `draft_id` (`integer`, required): Campaign draft ID. Example: 54321

Example input: `{"draft_id":54321}`

### `mailjet_contact_list_delete`

Delete Contact List · Destructive

Delete a contact list. The contacts themselves stay in the account.
Returns no content (204).

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`integer`, required): Contact list ID. Example: 12345

Example input: `{"list_id":12345}`

### `mailjet_parse_route_delete`

Delete Inbound Parse Route · Destructive

Delete an inbound parse route.
Returns no content (204).

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `parseroute_id` (`integer`, required): Parse route ID. Example: 123

Example input: `{"parseroute_id":123}`

### `mailjet_sender_delete`

Delete Sender · Destructive

Delete a sender address.
Returns no content (204).

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `sender_id` (`integer`, required): Sender ID. Example: 56789

Example input: `{"sender_id":56789}`

### `mailjet_template_delete`

Delete Template · Destructive

Delete a template.
Returns no content (204).

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `template_id` (`integer`, required): Template ID. Example: 1234567

Example input: `{"template_id":1234567}`

### `mailjet_webhook_delete`

Delete Event Webhook · Destructive

Delete an event webhook.
Returns no content (204).

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `url_id` (`integer`, required): Event webhook ID. Example: 123

Example input: `{"url_id":123}`

## Related

Other Communication connectors ([all 132](/agentkit/connectors/?category=communication)):

- [Gmail](/agentkit/connectors/gmail/): Scalekit connector, OAuth, 48 tools
- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Google Calendar](/agentkit/connectors/googlecalendar/): Scalekit connector, OAuth, 30 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
