{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/email-api/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["tabs","tab"]},"type":"markdown"},"seo":{"title":"Set global payload properties","siteUrl":"https://dev.mailjet.com/","projectTitle":"Mailjet Developer Documentation","description":"Simplify bulk Mailjet Send API v3.1 payloads with the Globals property to define shared values once and apply them across every object in the Messages array.","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":[]},"priority":0.8},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"set-global-payload-properties","__idx":0},"children":["Set global payload properties"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you are sending messages in bulk, often times some property values within your payload will be the same across multiple messages. To avoid repetition and simplify the structure of your payload, you can use Globals to specify specific properties. Those will then be applied to all message objects."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example","__idx":1},"children":["Example"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"cURL","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"shell","header":{"controls":{"copy":{}}},"source":"# This call sends a message to one recipient.\ncurl -s \\\n\t-X POST \\\n\t--user \"$MJ_APIKEY_PUBLIC:$MJ_APIKEY_PRIVATE\" \\\n\thttps://api.mailjet.com/v3.1/send \\\n\t-H 'Content-Type: application/json' \\\n\t-d '{\n    \"Globals\": {\n        \"From\": {\n            \"Email\": \"pilot@mailjet.com\",\n            \"Name\": \"Mailjet Pilot\"\n        },\n        \"Subject\": \"Your email flight plan!\"\n    },\n\t\t\"Messages\":[\n\t\t\t\t{\n\t\t\t\t\t\t\"To\": [\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\t\"Email\": \"passenger1@mailjet.com\",\n\t\t\t\t\t\t\t\t\t\t\"Name\": \"passenger 1\"\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t],\n\t\t\t\t\t\t\"TextPart\": \"Dear passenger 1, welcome to Mailjet! May the delivery force be with you!\",\n\t\t\t\t\t\t\"HTMLPart\": \"<h3>Dear passenger 1, welcome to <a href=\\\"https://www.mailjet.com/\\\">Mailjet</a>!</h3><br />May the delivery force be with you!\"\n\t\t\t\t},\n        {\n\t\t\t\t\t\t\"To\": [\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\t\"Email\": \"passenger2@mailjet.com\",\n\t\t\t\t\t\t\t\t\t\t\"Name\": \"passenger 2\"\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t],\n\t\t\t\t\t\t\"TextPart\": \"Dear passenger 2, welcome to Mailjet! \",\n\t\t\t\t\t\t\"HTMLPart\": \"<h3>Dear passenger 2, welcome to <a href=\\\"https://www.mailjet.com/\\\">Mailjet</a>!</h3><br />May the delivery force be with you!\"\n\t\t\t\t}\n\t\t]\n\t}'\n","lang":"shell"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"PHP","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"php","header":{"controls":{"copy":{}}},"source":"<?php\n/*\nThis call sends a message to one recipient.\n*/\nrequire 'vendor/autoload.php';\nuse \\Mailjet\\Resources;\n$mj = new \\Mailjet\\Client(getenv('MJ_APIKEY_PUBLIC'), getenv('MJ_APIKEY_PRIVATE'),true,['version' => 'v3.1']);\n$body = [\n    'Globals' => [\n        'From' => [\n            'Email' => \"pilot@mailjet.com\",\n            'Name' => \"Mailjet Pilot\"\n        ],\n        'Subject' => \"Your email flight plan!\"\n    ]\n    'Messages' => [\n        [\n            'To' => [\n                [\n                    'Email' => \"passenger1@mailjet.com\",\n                    'Name' => \"passenger 1\"\n                ]\n            ],\n            'TextPart' => \"Dear passenger 1, welcome to Mailjet! May the delivery force be with you!\",\n            'HTMLPart' => \"<h3>Dear passenger 1, welcome to <a href=\\\"https://www.mailjet.com/\\\">Mailjet</a>!</h3><br />May the delivery force be with you!\"\n        ],\n        [\n            'To' => [\n                [\n                    'Email' => \"passenger2@mailjet.com\",\n                    'Name' => \"passenger 2\"\n                ]\n            ],\n            'TextPart' => \"Dear passenger 2, welcome to Mailjet! May the delivery force be with you!\",\n            'HTMLPart' => \"<h3>Dear passenger 2, welcome to <a href=\\\"https://www.mailjet.com/\\\">Mailjet</a>!</h3><br />May the delivery force be with you!\"\n        ]        \n    ]\n];\n$response = $mj->post(Resources::$Email, ['body' => $body]);\n$response->success() && var_dump($response->getData());\n?>\n","lang":"php"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Node.js","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"/**\n *\n * This call sends a message to one recipient.\n *\n */\nconst mailjet = require ('node-mailjet')\n\t.connect(process.env.MJ_APIKEY_PUBLIC, process.env.MJ_APIKEY_PRIVATE)\nconst request = mailjet\n\t.post(\"send\", {'version': 'v3.1'})\n\t.request({\n    \"Globals\": {\n        \"From\": {\n            \"Email\": \"pilot@mailjet.com\",\n            \"Name\": \"Mailjet Pilot\"\n        },\n        \"Subject\": \"Your email flight plan!\"\n    },\n\t\t\"Messages\":[\n\t\t\t\t{\n\t\t\t\t\t\t\"To\": [\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\t\"Email\": \"passenger1@mailjet.com\",\n\t\t\t\t\t\t\t\t\t\t\"Name\": \"passenger 1\"\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t],\n\t\t\t\t\t\t\"TextPart\": \"Dear passenger 1, welcome to Mailjet! May the delivery force be with you!\",\n\t\t\t\t\t\t\"HTMLPart\": \"<h3>Dear passenger 1, welcome to <a href=\\\"https://www.mailjet.com/\\\">Mailjet</a>!</h3><br />May the delivery force be with you!\"\n\t\t\t\t},\n        {\n\t\t\t\t\t\t\"To\": [\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\t\"Email\": \"passenger2@mailjet.com\",\n\t\t\t\t\t\t\t\t\t\t\"Name\": \"passenger 2\"\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t],\n\t\t\t\t\t\t\"TextPart\": \"Dear passenger 2, welcome to Mailjet! \",\n\t\t\t\t\t\t\"HTMLPart\": \"<h3>Dear passenger 2, welcome to <a href=\\\"https://www.mailjet.com/\\\">Mailjet</a>!</h3><br />May the delivery force be with you!\"\n\t\t\t\t}\n\t\t]\n\t})\nrequest\n\t.then((result) => {\n\t\tconsole.log(result.body)\n\t})\n\t.catch((err) => {\n\t\tconsole.log(err.statusCode)\n\t})\n","lang":"javascript"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Ruby","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"ruby","header":{"controls":{"copy":{}}},"source":"# This call sends a message to one recipient.\nrequire 'mailjet'\nMailjet.configure do |config|\n  config.api_key = ENV['MJ_APIKEY_PUBLIC']\n  config.secret_key = ENV['MJ_APIKEY_PRIVATE']  \n  config.api_version = \"v3.1\"\nend\nvariable = Mailjet::Send.create(\n  globals: {\n    'From'=> {\n        'Email'=> 'pilot@mailjet.com',\n        'Name'=> 'Mailjet Pilot'\n    },\n    'Subject'=> 'Your email flight plan!'\n  }\n  messages: [{\n    'To'=> [\n        {\n            'Email'=> 'passenger1@mailjet.com',\n            'Name'=> 'passenger 1'\n        }\n    ],\n    'TextPart'=> 'Dear passenger 1, welcome to Mailjet! May the delivery force be with you!',\n    'HTMLPart'=> '<h3>Dear passenger 1, welcome to <a href=\\'https://www.mailjet.com/\\'>Mailjet</a>!</h3><br />May the delivery force be with you!'\n},\n{\n  'To'=> [\n      {\n          'Email'=> 'passenger2@mailjet.com',\n          'Name'=> 'passenger 2'\n      }\n  ],\n  'TextPart'=> 'Dear passenger 2, welcome to Mailjet! May the delivery force be with you!',\n  'HTMLPart'=> '<h3>Dear passenger 2, welcome to <a href=\\'https://www.mailjet.com/\\'>Mailjet</a>!</h3><br />May the delivery force be with you!'\n}]\n)\np variable.attributes['Messages']\n","lang":"ruby"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Python","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","header":{"controls":{"copy":{}}},"source":"\"\"\"\nThis call sends a message to one recipient.\n\"\"\"\nfrom mailjet_rest import Client\nimport os\napi_key = os.environ['MJ_APIKEY_PUBLIC']\napi_secret = os.environ['MJ_APIKEY_PRIVATE']\nmailjet = Client(auth=(api_key, api_secret), version='v3.1')\ndata = {\n  \"Globals\": {\n      \"From\": {\n          \"Email\": \"pilot@mailjet.com\",\n          \"Name\": \"Mailjet Pilot\"\n      },\n      \"Subject\": \"Your email flight plan!\"\n  },\n  \"Messages\":[\n      {\n          \"To\": [\n              {\n                  \"Email\": \"passenger1@mailjet.com\",\n                  \"Name\": \"passenger 1\"\n              }\n          ],\n          \"TextPart\": \"Dear passenger 1, welcome to Mailjet! May the delivery force be with you!\",\n          \"HTMLPart\": \"<h3>Dear passenger 1, welcome to <a href=\\\"https://www.mailjet.com/\\\">Mailjet</a>!</h3><br />May the delivery force be with you!\"\n      },\n      {\n          \"To\": [\n              {\n                  \"Email\": \"passenger2@mailjet.com\",\n                  \"Name\": \"passenger 2\"\n              }\n          ],\n          \"TextPart\": \"Dear passenger 2, welcome to Mailjet! \",\n          \"HTMLPart\": \"<h3>Dear passenger 2, welcome to <a href=\\\"https://www.mailjet.com/\\\">Mailjet</a>!</h3><br />May the delivery force be with you!\"\n      }\n  ]\n}\nresult = mailjet.send.create(data=data)\nprint result.status_code\nprint result.json()\n","lang":"python"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Java","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"java","header":{"controls":{"copy":{}}},"source":"package com.my.project;\nimport com.mailjet.client.errors.MailjetException;\nimport com.mailjet.client.errors.MailjetSocketTimeoutException;\nimport com.mailjet.client.MailjetClient;\nimport com.mailjet.client.MailjetRequest;\nimport com.mailjet.client.MailjetResponse;\nimport com.mailjet.client.ClientOptions;\nimport com.mailjet.client.resource.Emailv31;\nimport org.json.JSONArray;\nimport org.json.JSONObject;\npublic class MyClass {\n    /**\n     * This call sends a message to one recipient.\n     */\n    public static void main(String[] args) throws MailjetException, MailjetSocketTimeoutException {\n      MailjetClient client;\n      MailjetRequest request;\n      MailjetResponse response;\n      client = new MailjetClient(System.getenv(\"MJ_APIKEY_PUBLIC\"), System.getenv(\"MJ_APIKEY_PRIVATE\"), new ClientOptions(\"v3.1\"));\n      request = new MailjetRequest(Emailv31.resource)\n      .property(Emailv31.GLOBALS, new JSONObject()\n                .put(Emailv31.Message.FROM, new JSONObject()\n                    .put(\"Email\", \"pilot@mailjet.com\")\n                    .put(\"Name\", \"Mailjet Pilot\"))\n                .put(Emailv31.Message.SUBJECT, \"Your email flight plan!\")\n\t\t\t.property(Emailv31.MESSAGES, new JSONArray()\n                .put(new JSONObject()\n                    .put(Emailv31.Message.TO, new JSONArray()\n                        .put(new JSONObject()\n                            .put(\"Email\", \"passenger1@mailjet.com\")\n                            .put(\"Name\", \"passenger 1\")))\n                    .put(Emailv31.Message.TEXTPART, \"Dear passenger 1, welcome to Mailjet! May the delivery force be with you!\")\n                    .put(Emailv31.Message.HTMLPART, \"<h3>Dear passenger 1, welcome to <a href=\\\"https://www.mailjet.com/\\\">Mailjet</a>!</h3><br />May the delivery force be with you!\")));\n                    .put(new JSONObject()\n                        .put(Emailv31.Message.TO, new JSONArray()\n                            .put(new JSONObject()\n                                .put(\"Email\", \"passenger1@mailjet.com\")\n                                .put(\"Name\", \"passenger 2\")))\n                        .put(Emailv31.Message.TEXTPART, \"Dear passenger 2, welcome to Mailjet! May the delivery force be with you!\")\n                        .put(Emailv31.Message.HTMLPART, \"<h3>Dear passenger 2, welcome to <a href=\\\"https://www.mailjet.com/\\\">Mailjet</a>!</h3><br />May the delivery force be with you!\")));\n      response = client.post(request);\n      System.out.println(response.getStatus());\n      System.out.println(response.getData());\n    }\n}\n","lang":"java"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Go","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"go","header":{"controls":{"copy":{}}},"source":"/*\nThis call sends a message to one recipient.\n*/\npackage main\nimport (\n\t\"fmt\"\n\t\"log\"\n\t\"os\"\n\tmailjet \"github.com/mailjet/mailjet-apiv3-go\"\n)\nfunc main () {\n\tmailjetClient := NewMailjetClient(os.Getenv(\"MJ_APIKEY_PUBLIC\"), os.Getenv(\"MJ_APIKEY_PRIVATE\"))\n\tmessagesInfo := []mailjet.InfoMessagesV31 {\n      mailjet.InfoMessagesV31{\n        From: &mailjet.RecipientV31{\n          Email: \"pilot@mailjet.com\",\n          Name: \"Mailjet Pilot\",\n        },\n        To: &mailjet.RecipientsV31{\n          mailjet.RecipientV31 {\n            Email: \"passenger1@mailjet.com\",\n            Name: \"passenger 1\",\n          },\n        },\n        Subject: \"Your email flight plan!\",\n        TextPart: \"Dear passenger 1, welcome to Mailjet! May the delivery force be with you!\",\n        HTMLPart: \"<h3>Dear passenger 1, welcome to <a href=\\\"https://www.mailjet.com/\\\">Mailjet</a>!</h3><br />May the delivery force be with you!\",\n      },\n    }\n\tmessages := mailjet.MessagesV31{Info: messagesInfo }\n\tres, err := m.SendMailV31(&messages)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Printf(\"Data: %+v\\n\", res)\n}\n","lang":"go"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"C#","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"csharp","header":{"controls":{"copy":{}}},"source":"using Mailjet.Client;\nusing Mailjet.Client.Resources;\nusing System;\nusing Newtonsoft.Json.Linq;\nnamespace Mailjet.ConsoleApplication\n{\n   class Program\n   {\n      /// <summary>\n      /// This call sends a message to one recipient.\n      /// </summary>\n      static void Main(string[] args)\n      {\n         RunAsync().Wait();\n      }\n      static async Task RunAsync()\n      {\n         MailjetClient client = new MailjetClient(Environment.GetEnvironmentVariable(\"MJ_APIKEY_PUBLIC\"), Environment.GetEnvironmentVariable(\"MJ_APIKEY_PRIVATE\"))\n         {\n            Version = ApiVersion.V3_1,\n         };\n         MailjetRequest request = new MailjetRequest\n         {\n            Resource = Send.Resource,\n         }\n            .Property(Send.Globals, new JObject {\n              {\"From\", new JObject {\n               {\"Email\", \"pilot@mailjet.com\"},\n               {\"Name\", \"Mailjet Pilot\"}\n               }},\n              {\"Subject\", \"Your email flight plan!\"},\n            .Property(Send.Messages, new JArray {\n                new JObject {\n                 {\"To\", new JArray {\n                  new JObject {\n                   {\"Email\", \"passenger1@mailjet.com\"},\n                   {\"Name\", \"passenger 1\"}\n                   }\n                  }},\n                 {\"TextPart\", \"Dear passenger 1, welcome to Mailjet! May the delivery force be with you!\"},\n                 {\"HTMLPart\", \"<h3>Dear passenger 1, welcome to <a href=\\\"https://www.mailjet.com/\\\">Mailjet</a>!</h3><br />May the delivery force be with you!\"}\n                 }\n                new JObject {\n                 {\"To\", new JArray {\n                  new JObject {\n                   {\"Email\", \"passenger2@mailjet.com\"},\n                   {\"Name\", \"passenger 2\"}\n                   }\n                  }},\n                 {\"TextPart\", \"Dear passenger 2, welcome to Mailjet! May the delivery force be with you!\"},\n                 {\"HTMLPart\", \"<h3>Dear passenger 2, welcome to <a href=\\\"https://www.mailjet.com/\\\">Mailjet</a>!</h3><br />May the delivery force be with you!\"}\n                 }\n               });\n         MailjetResponse response = await client.PostAsync(request);\n         if (response.IsSuccessStatusCode)\n         {\n            Console.WriteLine(string.Format(\"Total: {0}, Count: {1}\\n\", response.GetTotal(), response.GetCount()));\n            Console.WriteLine(response.GetData());\n         }\n         else\n         {\n            Console.WriteLine(string.Format(\"StatusCode: {0}\\n\", response.StatusCode));\n            Console.WriteLine(string.Format(\"ErrorInfo: {0}\\n\", response.GetErrorInfo()));\n            Console.WriteLine(response.GetData());\n            Console.WriteLine(string.Format(\"ErrorMessage: {0}\\n\", response.GetErrorMessage()));\n         }\n      }\n   }\n}\n","lang":"csharp"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Globals"]}," you can specify values for all message properties, ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":["except"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["To"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Whenever a certain property is specified in both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Globals"]}," and a message object, the way they interact depends on the property type:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["String, integer and boolean properties will be overwritten by the message properties of the same name."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-1","__idx":2},"children":["Example:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Globals: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Subject\": \"Your email flight plan!\""]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Message: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Subject\": \"Your promo code!\""]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Final result: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Subject\": \"Your promo code!\""]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Object type properties (From, Sender, ReplyTo, TemplateErrorReporting, Headers, Variables) will be merged with the message property, overwriting any concurrent property."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-2","__idx":3},"children":["Example:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Globals: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"variables\" : {\"var1\":\"value1\",\"var2\":\"value2\"}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Message: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"variables\" : {\"var1\":\"value1_bis\",\"var3\":\"value3\"}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Final result: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"variables\" : {\"var1\":\"value1_bis\",\"var2\":\"value2\",\"var3\":\"value3\"}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Array type properties (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Cc, Bcc, Attachments, InlineAttachments"]},") will be appended."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-3","__idx":4},"children":["Example:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Globals: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Cc\" : [{\"Email\":\"passenger@mailjet.com\",\"Name\":\"passenger\"}]"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Message: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Cc\" : [{\"Email\":\"passenger2@mailjet.com\",\"Name\":\"passenger2\"}]"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Final result: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Cc\" : [{\"Email\":\"passenger@mailjet.com\",\"Name\":\"passenger\"}, {\"Email\":\"passenger2@mailjet.com\",\"Name\":\"passenger2\"}]"]}]}]},"headings":[{"value":"Set global payload properties","id":"set-global-payload-properties","depth":1},{"value":"Example","id":"example","depth":3},{"value":"Example:","id":"example-1","depth":4},{"value":"Example:","id":"example-2","depth":4},{"value":"Example:","id":"example-3","depth":4}],"frontmatter":{"title":"Mailjet Send API v3.1","seo":{"description":"Simplify bulk Mailjet Send API v3.1 payloads with the Globals property to define shared values once and apply them across every object in the Messages array.","priority":0.8,"title":"Set global payload properties"}},"lastModified":"2026-08-26T10:53:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/email-api/send-api-v31/set-global-payload-properties","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}