{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-openapi/openapi-mailjet.yaml","sidebar":"sidebar-docs/api-reference/sidebars.yaml"},"props":{"definitionId":"openapi/openapi-mailjet.yaml","dynamicMarkdocComponents":[],"baseSlug":"/openapi/openapi-mailjet","seo":{"title":"Mailjet API","siteUrl":"https://dev.mailjet.com/","projectTitle":"Mailjet Developer Documentation","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":[]}},"itemId":"","disableAutoScroll":true,"metadata":{"type":"openapi","title":"Mailjet API","description":"A complete collection of all publicly available endpoints and methods for the Mailjet API.\n\n## Status codes and errors\n\nThe Mailjet API uses conventional HTTP response codes to indicate the success or failure of an API request. Overall:\n\n- Codes in the `2xx` range indicate that the request was processed successfully.\n- Codes in the `4xx` range indicate that there was an error with the request (e.g. unauthorized access, a required parameter is missing etc.).\n- Codes in the `5xx` range indicate that there is an issue with Mailjet's servers.\n\nError responses will usually include an Error Identifier, Error Message and Status Code.\n\n| Code | Reason | Description |\n| --- | --- | --- |\n| `200` | OK | All went well. Congrats! |\n| `201` | Created | The `POST` request was successfully executed. |\n| `204` | No Content | No content found or expected to return. Returned when a `DELETE` request was successful. |\n| `304` | Not Modified | The `PUT` request didn't affect any record. |\n| `400` | Bad Request | One or more parameters are missing or maybe misspelled (unknown resource or action). |\n| `401` | Unauthorized | You have specified an incorrect API Key / API Secret Key pair. You may be unauthorized to access the API or your API key may be inactive. Visit the API keys Management section to check your keys. |\n| `403` | Forbidden | You are not authorized to access this resource. |\n| `404` | Not Found | The resource with the specified ID you are trying to reach does not exist. |\n| `405` | Method Not Allowed | The method requested on the resource does not exist. |\n| `429` | Too Many Requests | You have reached the maximum number of calls allowed per minute by our API. Please review your integration to reduce the number of calls issued by your system. |\n| `500` | Internal Server Error | Something went wrong on our side. When such an error occurs, the response contains an error identifier (e.g. `\"ErrorIdentifier\": \"D4DF574C-0C5F-45C7-BA52-7AA8E533C3DE\"`), which is crucial for tracking the problem and identifying the root cause. Please contact our support team, providing the error identifier. |"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"dev.mailjet.com","port":4000,"ipAddress":"216.73.216.103"},"lang":"default_locale","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"main"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/openapi/openapi-mailjet","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}