> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecomail.cz/llms.txt
> Use this file to discover all available pages before exploring further.

# Send transactional template

> Send a transactional email using a pre-defined template.

<ParamField body="message" type="object" required>
  The message object containing all email details.

  <Expandable title="message properties">
    <ParamField body="message.template_id" type="integer" required>
      ID of the template to use.
    </ParamField>

    <ParamField body="message.subject" type="string" required>
      Email subject line.
    </ParamField>

    <ParamField body="message.from_name" type="string" required>
      Sender's display name.
    </ParamField>

    <ParamField body="message.from_email" type="string" required>
      Sender's email address. Must be from a verified domain.
    </ParamField>

    <ParamField body="message.reply_to" type="string">
      Reply-to email address.
    </ParamField>

    <ParamField body="message.to" type="array" required>
      Array of recipient objects.

      <Expandable title="recipient object properties">
        <ParamField body="message.to[].email" type="string" required>
          Recipient's email address.
        </ParamField>

        <ParamField body="message.to[].name" type="string">
          Recipient's display name.
        </ParamField>

        <ParamField body="message.to[].cc" type="string">
          CC email address.
        </ParamField>

        <ParamField body="message.to[].bcc" type="string">
          BCC email address.
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="message.global_merge_vars" type="array">
      Array of merge tag objects for personalization.

      <Expandable title="merge var properties">
        <ParamField body="message.global_merge_vars[].name" type="string">
          Merge tag name.
        </ParamField>

        <ParamField body="message.global_merge_vars[].content" type="string">
          Merge tag value.
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="message.attachments" type="array">
      Array of attachment objects.

      <Expandable title="attachment properties">
        <ParamField body="message.attachments[].type" type="string">
          MIME type of the attachment.
        </ParamField>

        <ParamField body="message.attachments[].name" type="string">
          File name of the attachment.
        </ParamField>

        <ParamField body="message.attachments[].content" type="string">
          Base64 encoded file content.
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="message.options" type="object">
      Tracking options.

      <Expandable title="options properties">
        <ParamField body="message.options.click_tracking" type="boolean">
          Enable click tracking.
        </ParamField>

        <ParamField body="message.options.open_tracking" type="boolean">
          Enable open tracking.
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://api2.ecomailapp.cz/transactional/send-template \
    -H "key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "message": {
        "template_id": 1,
        "subject": "Email subject",
        "from_name": "Sender'\''s name",
        "from_email": "foo@bar.cz",
        "reply_to": "foo@bar.cz",
        "to": [
          {
            "email": "to@me.com",
            "name": "Recipient'\''s name"
          }
        ],
        "global_merge_vars": [
          {"name": "mergeTagName", "content": "mergeTagValue"}
        ],
        "options": {
          "click_tracking": true,
          "open_tracking": true
        }
      }
    }'
  ```

  ```php PHP theme={null}
  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, 'https://api2.ecomailapp.cz/transactional/send-template');
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_POST, true);
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      'key: YOUR_API_KEY',
      'Content-Type: application/json',
  ]);
  curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
      'message' => [
          'template_id' => 1,
          'subject' => 'Email subject',
          'from_name' => "Sender's name",
          'from_email' => 'foo@bar.cz',
          'reply_to' => 'foo@bar.cz',
          'to' => [
              [
                  'email' => 'to@me.com',
                  'name' => "Recipient's name",
              ],
          ],
          'global_merge_vars' => [
              ['name' => 'mergeTagName', 'content' => 'mergeTagValue'],
          ],
          'options' => [
              'click_tracking' => true,
              'open_tracking' => true,
          ],
      ],
  ]));
  $response = curl_exec($ch);
  curl_close($ch);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "results": {
      "total_rejected_recipients": 0,
      "total_accepted_recipients": 2,
      "id": 11668787484950529
    }
  }
  ```
</ResponseExample>