{"Status":true,"Message":"","Response":{"post":{"postuid":"0f3b958f-9f32-42a7-94e0-2e3b33aa7a1c","tenantuid":"d8b744fc-2e70-4089-bb80-dd1d08f6c7b2","projectuid":"542e5f51-33cf-401f-aebe-4324ebe36fe4","title":"Send Email","slug":"reference/sends-email-to-lead","html":"\u003Cp\u003E\u003C/p\u003E\u003Ch2 id=\u0022api_query_parameters\u0022\u003EAPI Query Parameters\u003C/h2\u003E\u003Cp\u003EThe API accepts either a single dsid (DailyStory unique id) or a comma separated list of email addresses. If\u0026nbsp;\u003Ccode\u003Eemail\u003C/code\u003E\u0026nbsp;query string parameter has a value, the dsid value will be ignored.\u003C/p\u003E\u003Cul\u003E\u003Cli\u003E\u003Ccode\u003Eemail\u003C/code\u003E\u0026nbsp;- The email parameter accepts a single example address, e.g.\u0026nbsp;\u003Ccode\u003Eemail=person@example.com\u003C/code\u003E, or a comma separate list of email addresses, e.g.\u0026nbsp;\u003Ccode\u003Eemail=person1@example.com,person2@example.com\u003C/code\u003E\u003C/li\u003E\u003C/ul\u003E\u003Ccite class=\u0022important\u0022\u003E\u003Cspan class=\u0022title\u0022\u003EImportant\u003C/span\u003E\u003Cp\u003EIf both the email address and the dsid parameter is sent, the implied intent is that the email address is preferred and the dsid is a fallback.\u003C/p\u003E\u003C/cite\u003E\u003Cp\u003EAny email addresses that are invalid or are attempted to be used for invalid contacts will be ignored.\u003C/p\u003E\u003Ch2 id=\u0022json_body\u0022\u003EJSON Body\u003C/h2\u003E\u003Cp\u003EOptionally include a JSON body with properties used to personalize the email.\u003C/p\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022json\u0022\u003E{\r\n  \u0026quot;subject\u0026quot;:\u0026quot;My new email subject\u0026quot;,\t\t\t\t\t\t// optional to set a subject\r\n  \u0026quot;from\u0026quot;:\u0026quot;hello@example.com\u0026quot;,\t\t\t\t\t\t\t\t\t// optional set a from address\r\n  \u0026quot;confirmation_url\u0026quot;:\u0026quot;https://example.com\u0026quot;,\t\t// optional set a profile field\r\n  \u0026quot;confirmation_code\u0026quot;:\u0026quot;confirmation-38474\u0026quot;\t\t// optional set a profile field\r\n}\u003C/div\u003E\u003C/div\u003E\u003Cp\u003EThese fields are then accessible in the email. The following fields are reserved field and for a templated email that is sent these fields are usually already set.\u003C/p\u003E\u003Cul\u003E\u003Cli\u003E\u003Ccode\u003Esubject\u003C/code\u003E\u0026nbsp;- set an alternate subject for the email.\u003C/li\u003E\u003Cli\u003E\u003Ccode\u003Efrom\u003C/code\u003E\u0026nbsp;- set an alternate from address for the email.\u003C/li\u003E\u003Cli\u003E\u003Ccode\u003Epreheader\u003C/code\u003E- set an alternate\u0026nbsp;\u003Ca target=\u0022_self\u0022 href=\u0022https://www.dailystory.com/blog/email-preheader-improve-open-rates/\u0022\u003Epreheader\u003C/a\u003E\u0026nbsp;for the email.\u003C/li\u003E\u003Cli\u003E\u003Ccode\u003Eplaintext\u003C/code\u003E- set an alternate plaintext for the email.\u003C/li\u003E\u003Cli\u003E\u003Ccode\u003Ecc\u003C/code\u003E\u0026nbsp;-\u0026nbsp;\u003Ca target=\u0022_self\u0022 href=\u0022https://www.dailystory.com/glossary/cc-email/\u0022\u003Ecarbon copy recipients\u003C/a\u003E. Must be in standard email format. Multiple addresses should be separated with a semi-colon.\u003C/li\u003E\u003Cli\u003E\u003Ccode\u003Ebcc\u003C/code\u003E\u0026nbsp;-\u0026nbsp;\u003Ca target=\u0022_self\u0022 href=\u0022https://www.dailystory.com/glossary/bcc-email/\u0022\u003Eblind carbon copy\u003C/a\u003E\u0026nbsp;recipient. Must be in standard email format. Multiple addresses should be separated with a semi-colon.\u003C/li\u003E\u003Cli\u003E\u003Ccode\u003Ereply-to\u003C/code\u003E\u0026nbsp;- set the\u0026nbsp;\u003Ca target=\u0022_self\u0022 href=\u0022https://www.dailystory.com/glossary/reply-to-header/\u0022\u003Ereply-to header\u003C/a\u003E\u0026nbsp;of the email. Must be in standard email format. Only a single address is allowed.\u003C/li\u003E\u003C/ul\u003E\u003Cp\u003EFor example:\u003C/p\u003E\u003Cp\u003EHello, your confirmation code is\u003Ccode\u003E{{profile.confirmation_code}}\u003C/code\u003E.\u003C/p\u003E\u003Cp\u003EIt\u0027s also possible to send a subject or from with a personalization token, for example:\u003C/p\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022json\u0022\u003E{\r\n  \u0026quot;subject\u0026quot;:\u0026quot;Your id is {{@profile.custom_id}}\u0026quot;\r\n}\u003C/div\u003E\u003C/div\u003E\u003Cp\u003EWhen the email is sent if the contact has a personalization field of\u0026nbsp;\u003Ccode\u003Ecustom_id\u003C/code\u003E\u0026nbsp;it will automatically be inserted.\u0026nbsp;\u0026nbsp;\u003C/p\u003E\u003Cdiv class=\u0022api_header\u0022\u003EPath Parameters\u003C/div\u003E\u003Csection class=\u0022api_parameters\u0022\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Eid\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Enumber\u003C/span\u003E\u003Cspan class=\u0022p_isrequired\u0022\u003Erequired\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EId of the email to send.\u003C/div\u003E\u003C/section\u003E\u003C/section\u003E\u003Cdiv class=\u0022api_header\u0022\u003EQuery Parameters\u003C/div\u003E\u003Csection class=\u0022api_parameters\u0022\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Edsid\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Estring\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EThe dsid of a single contact to send to. Ignored if \u003Ccode\u003Eemail\u003C/code\u003E is also provided.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Eemail\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Estring\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EA single email address or a comma-separated list of email addresses. When provided, \u003Ccode\u003Edsid\u003C/code\u003E is ignored and each address is resolved to (or created as) a contact.\u003C/div\u003E\u003C/section\u003E\u003C/section\u003E\u003Cdiv class=\u0022api_header\u0022\u003EHTTP Request Examples\u003C/div\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022d-flex header\u0022\u003E\u003C/div\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022json\u0022\u003E{\r\n  \u0026quot;subject\u0026quot;:\u0026quot;My new email subject\u0026quot;,\r\n  \u0026quot;from\u0026quot;:\u0026quot;hello@example.com\u0026quot;,\r\n  \u0026quot;confirmation_url\u0026quot;:\u0026quot;https://example.com\u0026quot;,\r\n  \u0026quot;confirmation_code\u0026quot;:\u0026quot;confirmation-38474\u0026quot;\r\n}\u003C/div\u003E\u003C/div\u003E\u003Cdiv class=\u0022api_header\u0022\u003EHTTP Request Parameters\u003C/div\u003E\u003Csection class=\u0022api_parameters\u0022\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Esubject, from, preheader, plaintext, cc, bcc, reply-to\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Estring\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EOptional per-send overrides for the corresponding email header fields.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Eattachments\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Estring\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EOptional base64-encoded JSON map of \u003Ccode\u003Efilename \u2192 base64-encoded file bytes\u003C/code\u003E. See \u003Ca href=\u0022/reference/send-to-single-contact#adding-attachments-to-a-transactional-email\u0022\u003EIncluding Attachments\u003C/a\u003E for the encoding recipe.\u003C/div\u003E\u003C/section\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003E(custom personalization fields)\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Estring\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EAny other JSON body keys are merged onto the contact\u0027s lead as extended properties and become available as \u003Ccode\u003E{{profile.\u003Ckey\u003E}}\u003C/code\u003E personalization tokens within the email body, subject, or from address.\u003C/div\u003E\u003C/section\u003E\u003C/section\u003E\u003Cdiv class=\u0022api_header\u0022\u003EHTTP Response Examples\u003C/div\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022d-flex header\u0022\u003E\u003Cspan class=\u0022httpstatus\u0022\u003E\u003Cspan class=\u0022solid-circle success\u0022\u003E\u003C/span\u003E200\u003C/span\u003E\u003Cspan\u003ESingle recipient\u003C/span\u003E\u003C/div\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022json\u0022\u003E{\r\n  \u0026quot;Status\u0026quot;: true,\r\n  \u0026quot;Message\u0026quot;: \u0026quot;Email sent\u0026quot;,\r\n  \u0026quot;Response\u0026quot;: {\r\n    \u0026quot;messageid\u0026quot;: \u0026quot;20231127164859.ee81700d9b371f25@mg.dailystory.net\u0026quot;\r\n  }\r\n}\u003C/div\u003E\u003C/div\u003E\u003Cdiv class=\u0022code_wrapper\u0022\u003E\u003Cdiv class=\u0022d-flex header\u0022\u003E\u003Cspan class=\u0022httpstatus\u0022\u003E\u003Cspan class=\u0022solid-circle success\u0022\u003E\u003C/span\u003E200\u003C/span\u003E\u003Cspan\u003EMultiple recipients (email=a@x.com,b@x.com)\u003C/span\u003E\u003C/div\u003E\u003Cdiv class=\u0022code\u0022 data-language=\u0022json\u0022\u003E{\r\n  \u0026quot;Status\u0026quot;: true,\r\n  \u0026quot;Message\u0026quot;: \u0026quot;Email sent\u0026quot;,\r\n  \u0026quot;Response\u0026quot;: {\r\n    \u0026quot;messageid\u0026quot;: [\r\n      \u0026quot;20231127164859.ee81700d9b371f25@mg.dailystory.net\u0026quot;,\r\n      \u0026quot;20231127164859.aa42199b0ed42c11@mg.dailystory.net\u0026quot;\r\n    ]\r\n  }\r\n}\u003C/div\u003E\u003C/div\u003E\u003Cdiv class=\u0022api_header\u0022\u003EHTTP Response Parameters\u003C/div\u003E\u003Csection class=\u0022api_parameters\u0022\u003E\u003Csection class=\u0022api_param\u0022\u003E\u003Cdiv class=\u0022api_param_header\u0022\u003E\u003Cspan class=\u0022p_name\u0022\u003Emessageid\u003C/span\u003E\u003Cspan class=\u0022p_type\u0022\u003Estring | array\u003C/span\u003E\u003C/div\u003E\u003Cdiv\u003EThe Mailgun message id of the sent email. When sending to a single recipient this is a string; when sending to a comma-separated list of emails it is an array of message ids, one per successful send (individual failures are silently skipped).\u003C/div\u003E\u003C/section\u003E\u003C/section\u003E","json_meta":{"api_verb":"POST","api_path":"https://us-1.dailystory.com/api/v1/email/send/{id}"},"publish_status":0,"post_type":"API","authoruid":"3dde8c16-763a-4a2b-ae0b-1d8c50c62e3d","author":{"authoruid":"3dde8c16-763a-4a2b-ae0b-1d8c50c62e3d"},"featured_image_updating":false,"meta_description":"Learn how to use API query parameters and JSON body to send personalized emails, including supported fields, response formats, and parameter examples.","display_toc":true,"has_workingcopy":false,"allow_indexing":true,"sort_order":5,"total_views":0,"date_published":"2026-04-20T12:00:00","date_updated":"2026-04-20T14:11:41.187","date_created":"2025-09-29T14:16:23.957"}}}