Mailjet API version

[fabr2004]

At Mailjet Dev guide it is stated that API 3.1 was released +5 years ago (source).
This Github project seems to run older API version 3.
Is this correct?

[dmytrosvystun88]

Currently Mailjet API is spread under 3 versions: https://dev.mailjet.com/email/reference/overview/versioning/

Regarding the Github Mailjet api wrapper project:

SendTransactionalEmail methods in MailjetClient use API 3.1 version:

Basically client wrapper will determine what API version to call under the hood (V3, V3.1 or V4). Example:

[fabr2004]

Thanks for the clarification.

I was trying to implement Mailjet Dev guide (https://dev.mailjet.com/email/guides/send-api-v31/) to send transactional e-mails.
The guide states (see below) to place Version = ApiVersion.V3_1 but this was not allowed, caused an error.
We had <package id="Mailjet.Api" version="3.0.0" targetFramework="net48" />.

While investigating this I noticed Nuget package is described as "Official C# client library For Mailjet API version 3" and has "project URL" pointed here. So, since Mailjet informs latest e-mail API to be v3.1, I was wondering if maybe I got the wrong package version, then I posted here to get clarifications.

Unfortunately, we couldn't have this package working as expected, so we uninstalled this package shortly after.

Our latest attempts were made with a httpClient PostAsync, where "success" was returned but we didn't receive the test mail sent. Same happened with Postman request. Opened Mailjet support tickets but still waiting for additional clarification.

Reference guide:

[thomaswollburg]

The Version property doesnt seem to exist, and the automagic usage of the API to use does not work as intended either, the example for @fabr2004 s screen will not compile here - however, sticking to API v3 seems to fix the issue... also, mails had no content when using HTMPPart - they get send and ewverything, but have no content :/

Sub account API key did not work for me as well and triggered an invalid sender warning with the API key instead of the sender address.

[Flaflo]

I think this is very weird. Why isnt there any clarification or changes in the guide or code?

[amarkezic]

Thanks for the clarification.

I was trying to implement Mailjet Dev guide (https://dev.mailjet.com/email/guides/send-api-v31/) to send transactional e-mails. The guide states (see below) to place Version = ApiVersion.V3_1 but this was not allowed, caused an error. We had <package id="Mailjet.Api" version="3.0.0" targetFramework="net48" />.

While investigating this I noticed Nuget package is described as "Official C# client library For Mailjet API version 3" and has "project URL" pointed here. So, since Mailjet informs latest e-mail API to be v3.1, I was wondering if maybe I got the wrong package version, then I posted here to get clarifications.

Unfortunately, we couldn't have this package working as expected, so we uninstalled this package shortly after.

Our latest attempts were made with a httpClient PostAsync, where "success" was returned but we didn't receive the test mail sent. Same happened with Postman request. Opened Mailjet support tickets but still waiting for additional clarification.

Reference guide:

Same here, client returns 200 response, but email is not sent when using:

        var request = new MailjetRequest
        {
            Resource = Send.Resource,
        }
        .Property(Send.FromEmail, _emailConfiguration.SenderEmail)
        .Property(Send.Subject, subject)
        .Property(Send.TextPart, body)
        .Property(Send.HtmlPart, body)
        .Property(Send.Recipients, new JArray {
            new JObject {
                {"Email", toEmail}
                }
            });

        var response = await _mailJetClient.PostAsync(request);

[Flaflo]

After digging through the source, I eventually got it working by doing the following:

var request = new MailjetRequest { Resource = SendV31.Resource }
        .Property(Mailjet.Client.Resources.Send.Messages, new JArray {
            new JObject {
                {"From", new JObject {
                    {"Email", "mail@example.com"},
                    {"Name", "No-Reply Example"}
                }},
                {"To", new JArray {
                    new JObject {
                        {"Email", "john.doe@gmail.com"},
                    }
                }},
                {"TemplateID", 2141221},
                {"TemplateLanguage", true},
                {"Subject", "Example"},
                {"Variables", new JObject {
                    {"name_first", "John Doe"}, 
                }}
            }
        });

var response = await _client.PostAsync(request);

[ywingdriver]

@Flaflo Thank you for that workaround, just confirmed that the following steps can fix the code from the MailJet documentation on sending on API version 3.1:

1. Comment out the version code

var client = new MailjetClient(MarketingAPIKey, MarketingSecretKey) { //Version = ApiVersion.V3_1, };

2. Modify Send.Resource to be SendV31.Resource

var request = new MailjetRequest { Resource = SendV31.Resource, }

[juhaalhojoki]

Thanks @Flaflo and @ywingdriver for having a solution for the issue.

I'm also wondering about sending emails in bulk https://dev.mailjet.com/email/guides/send-api-v31/#send-in-bulk after seeing the implementation for Mailjet.Client.Resources > SendV31 at

mailjet-apiv3-dotnet/Mailjet.Client/Resources/SendV31.cs

Line 10 in 271c62b

public const int MaxEmailsPerBatch = 50;

that does the MaxEmailsPerBatch mean that there is a limit of 50 emails per batch. Didn't find anything related to this limitation in the documentation but am going to implement utilizing the client with that limit and not trying to send more than 50 emails in one batch since the MaxEmailsPerBatch constant is public.

EDIT: it probably does so it is a good idea not to try to send more than 50 emails in a batch when using Api version 3.1:

mailjet-apiv3-dotnet/Mailjet.Client/MailjetClient.cs

Line 141 in 271c62b

throw new MailjetClientConfigurationException($"Send Emails API v3.1 allows to send not more than {SendV31.MaxEmailsPerBatch} emails per call");

[VictorZhong4475]

After digging through the source, I eventually got it working by doing the following:

var request = new MailjetRequest { Resource = SendV31.Resource }
        .Property(Mailjet.Client.Resources.Send.Messages, new JArray {
            new JObject {
                {"From", new JObject {
                    {"Email", "mail@example.com"},
                    {"Name", "No-Reply Example"}
                }},
                {"To", new JArray {
                    new JObject {
                        {"Email", "john.doe@gmail.com"},
                    }
                }},
                {"TemplateID", 2141221},
                {"TemplateLanguage", true},
                {"Subject", "Example"},
                {"Variables", new JObject {
                    {"name_first", "John Doe"}, 
                }}
            }
        });

var response = await _client.PostAsync(request);

You solved my problem,now I got the message