{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/email-api/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Create a Sender - Mailjet Email API","siteUrl":"https://dev.mailjet.com/","projectTitle":"Mailjet Developer Documentation","description":"Register a sender address or catch-all domain in Mailjet via POST /sender; the API auto-creates a /dns entry for SPF and DKIM configuration on your account.","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":"senders-and-domains","__idx":0},"children":["Senders and Domains"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To send your emails you have to add a sender email address or domain to your API key and validate it. You can do so from the Mailjet app or via the API."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition, you will need to modify your DNS records to include DKIM signature and SPF. This will help Inbox Service Providers (ISPs) and webmail servers (e.g. Gmail or Yahoo) verify that the emails are being sent from an authorized server. Once setup, SPF & DKIM will also help with your deliverability – meaning your emails have a better chance of being delivered to the recipient’s inbox and not their spam folder."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"create-a-sender","__idx":2},"children":["Create a sender"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create a new sending address for your API key, do a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," on the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/sender"]}," resource."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the payload set the value of Email to the respective address. To register an email domain, you can use a catch-all expression like ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*@yourdomain.com"]}," instead."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Whenever you register a sender, the domain name will be extracted from the email address and the system will create a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dns"]}," entry for it. Do a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/dns/{dns_ID or dns_domain}"]}," to get the SPF, DKIM and sender validation information for this domain."]}]}]},"headings":[{"value":"Senders and Domains","id":"senders-and-domains","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Create a sender","id":"create-a-sender","depth":1}],"frontmatter":{"title":"Mailjet Senders and Domains","seo":{"title":"Create a Sender - Mailjet Email API","description":"Register a sender address or catch-all domain in Mailjet via POST /sender; the API auto-creates a /dns entry for SPF and DKIM configuration on your account."}},"lastModified":"2026-08-26T10:53:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/email-api/senders-domains/create-sender","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}