{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/email-api/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"About the Mailjet Email API - Mailjet Email API Guide","siteUrl":"https://dev.mailjet.com/","projectTitle":"Mailjet Developer Documentation","description":"Mailjet Email API uses REST principles, HTTP methods, and JSON over HTTPS. Covers versioning, rate limits, and bulk endpoint strategies.","image":"https://dev.mailjet.com/og-image.png","lang":"en-US","keywords":["Mailjet API","Email API","Content API","SMTP Relay","transactional email","email delivery","Send API","email templates","developer documentation"],"meta":[{"name":"og:type","content":"website"},{"name":"og:site_name","content":"Mailjet Developer Documentation"},{"name":"twitter:card","content":"summary_large_image"},{"name":"robots","content":"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1"},{"name":"googlebot","content":"index, follow, max-snippet:-1, max-image-preview:large"}],"jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://dev.mailjet.com/#organization","name":"Mailjet","alternateName":"Sinch Mailjet","url":"https://www.mailjet.com","logo":"https://assets.mailjet.com/lib/images/mailjetLogo/mj_logo_with_text_color.png","parentOrganization":{"@type":"Organization","name":"Sinch","url":"https://www.sinch.com"}},{"@type":"WebSite","@id":"https://dev.mailjet.com/#website","name":"Mailjet Developer Documentation","description":"Official developer documentation for the Mailjet Email API, Content API and SMTP Relay.","url":"https://dev.mailjet.com/","inLanguage":"en-US","publisher":{"@id":"https://dev.mailjet.com/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://dev.mailjet.com/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]},"llmstxt":{"hide":false,"title":"Mailjet Developer Documentation","description":"Developer documentation for the Mailjet Email API, Content API and SMTP Relay - guides, API references and code samples for sending, templating and tracking email at scale.","details":{"content":"Mailjet (part of Sinch) provides APIs for sending and managing email.\n\nThis documentation covers four main areas:\n\n- **Email API** - the Send API (v3 and v3.1) for transactional and marketing email,\n  plus contact management, segmentation, campaigns, statistics, webhooks, the Parse API\n  and the Mailjet Templating Language.\n- **Content API** - programmatic management of email templates, template contents,\n  images, labels and authentication tokens (v1).\n- **SMTP Relay** - sending through Mailjet's SMTP servers, including custom headers.\n- **API Reference** - the complete, generated reference for every endpoint, built directly\n  from the OpenAPI specifications.\n\nBase URL for all REST APIs: `https://api.mailjet.com`.\nAuthentication uses HTTP Basic auth with an API key and secret key.\n\n## Machine-readable entry points\n\nPrefer these when you need the API surface in as few requests as possible:\n\n- `/openapi/openapi-mailjet.md` - the **complete** Email API reference (every endpoint,\n  grouped by resource) as a single Markdown document.\n- `/openapi/openapi-passport.md` - the **complete** Content API reference as a single\n  Markdown document.\n- `/_bundle/openapi/openapi-mailjet.yaml` - the raw, fully bundled OpenAPI 3 description\n  of the Email API.\n- `/_bundle/openapi/openapi-passport.yaml` - the raw, fully bundled OpenAPI 3 description\n  of the Content API.\n- `/sitemap.xml` - every indexable URL on this site.\n\nEvery page on this site is also available as clean Markdown by appending `.md` to its URL."},"sections":[{"title":"Email API","description":"Sending, contacts, campaigns, statistics, webhooks and templating.","includeFiles":["docs/email-api/**/*.md"],"excludeFiles":[]},{"title":"Content API","description":"Manage templates, template contents, images, labels and tokens.","includeFiles":["docs/content-api/**/*.md","docs/content-api.md"],"excludeFiles":[]},{"title":"SMTP Relay","description":"Send email through Mailjet's SMTP servers.","includeFiles":["docs/smtp-relay/**/*.md"],"excludeFiles":[]},{"title":"API Reference","description":"Complete generated reference for every Mailjet API endpoint.","includeFiles":["openapi/openapi-mailjet.yaml","openapi/openapi-passport.yaml","docs/api-reference/**/*.md"],"excludeFiles":[]},{"title":"Migrating from Mandrill","description":"Guides for switching from Mandrill to Mailjet.","includeFiles":["docs/mandrill/**/*.md"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"about-the-mailjets-email-api","__idx":0},"children":["About the Mailjet's Email API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Hello and welcome to the Mailjet's Email API!"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Mailjet APIs are built using ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://en.wikipedia.org/wiki/Representational_State_Transfer"},"children":["RESTful principles"]},", featuring clear and consistent resource-oriented URLs for easy integration. It uses standard HTTP methods like ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE"]}," to interact with resources, and returns structured ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"http://www.json.org/"},"children":["JSON"]}," for all requests and responses—including errors. Each API request is made over ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://en.wikipedia.org/wiki/HTTPS"},"children":["HTTPS"]}," to a versioned endpoint, ensuring secure and predictable communication. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/email-api/email-api-overview/status-codes"},"children":["HTTP status codes"]}," are used to indicate the success or failure of requests, making error handling straightforward for developers."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the Mailjet API, all PUT requests behave like PATCH requests. The update will affect only the specified properties. The other properties of an existing resource will neither be modified, nor deleted. It also means that all non-mandatory properties can be omitted from your payload."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"versioning","__idx":1},"children":["Versioning"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Mailjet API is spread under 3 versions."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/email-api/send-api-v3/send-basic-email"},"children":["V3"]},": This includes all REST API resources and one transactional API resource."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/email-api/send-api-v31/send-basic-email"},"children":["V3.1"]},": A second transactional API which includes advanced error management."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/content-api/content-overview/content-overview"},"children":["V1"]},": The Content API is under V1"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"version-differences","__idx":2},"children":["Version Differences"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["One of the main differences between the V3 and V1 versions is a change in authentication:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["V3s are using basic authentication with your public and secret API keys."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["V1 leverages a token authentication."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The URL paths for every API resource can be found in the API reference under the respective resource name."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rate-limits","__idx":3},"children":["Rate Limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Mailjet APIs are under rate limits for the number of API calls allowed per API keys per second. If you reach a rate limit, our API will return a 429 HTTP error code."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Our transactional APIs (Email and SMS) are offering a high rate limit to accommodate the most demanding messaging needs of our clients. The rate limits for the rest of our Email and SMS APIs (excluding transactional API calls) are much lower, while still allowing a comfortable use of our API by even the most challenging use cases."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To help better deal with these rate limitations, we have put in place Bulk functionalities, helping you increase the quantity of actions you can do with a single call. These functionalities are available for transactional endpoints and contact management endpoints."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When using the Mailjet API, we recommend to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Properly take into account any 429 error (wait and retry)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For high frequency use of our API resources, explore the use of our bulk functionalities"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Separate applications under separate sub accounts"]}]}]},"headings":[{"value":"About the Mailjet's Email API","id":"about-the-mailjets-email-api","depth":1},{"value":"Versioning","id":"versioning","depth":2},{"value":"Version Differences","id":"version-differences","depth":4},{"value":"Rate Limits","id":"rate-limits","depth":2}],"frontmatter":{"title":"Mailjet API","seo":{"title":"About the Mailjet Email API - Mailjet Email API Guide","description":"Mailjet Email API uses REST principles, HTTP methods, and JSON over HTTPS. Covers versioning, rate limits, and bulk endpoint strategies."}},"lastModified":"2026-08-26T10:53:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/email-api/email-api-overview/about-mailjet-api","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}