category: Email
provider: Open Source
commonfields:
  id: Mail Sender (New)
  version: -1
sectionorder:
- Connect
- Collect
configuration:
- display: Mail server hostname or IP address
  name: host
  required: true
  type: 0
  section: Connect
- defaultvalue: '25'
  display: SMTP Port
  name: port
  required: true
  type: 0
  section: Connect
- display: Credentials
  name: credentials
  type: 9
  required: false
  section: Connect
- defaultvalue: Cortex XSOAR <noreply@demisto.com>
  display: Sender address
  name: from
  required: true
  type: 0
  section: Connect
  additionalinfo: Sender address can be specified as 'user@host.com' or 'Full Name <user@host.com>'
- display: Fully Qualified Domain Name (FQDN) - used in EHLO
  name: fqdn
  type: 0
  required: false
  section: Connect
- display: Connection Security
  additionalinfo: The connection security. The `SSL/TLS` first establishes a secure `SSL/TLS` connection and conducts SMTP over that connection, and STARTTLS starts with unencrypted SMTP and then switches to SSL/TLS to ensure security.
  name: tls
  defaultvalue: "None"
  type: 15
  options:
  - None
  - STARTTLS
  - SSL/TLS
  required: false
  section: Connect
- defaultvalue: 'false'
  display: Trust any certificate (not secure)
  name: insecure
  type: 8
  required: false
  section: Connect
description: Send emails implemented in Python with embedded image support.
display: Mail Sender (New)
name: Mail Sender (New)
script:
  commands:
  - arguments:
    - default: true
      description: Email addresses for the 'To' field.
      isArray: true
      name: to
    - description: Email addresses for the 'Cc' field.
      isArray: true
      name: cc
    - description: Email addresses for the 'Bcc' field.
      isArray: true
      name: bcc
    - description: Subject for the email to be sent.
      name: subject
    - description: The contents (body) of the email to be sent in plain text.
      name: body
    - description: The contents (body) of the email to be sent in HTML format.
      name: htmlBody
    - description: Address that should be used to reply to the message.
      name: replyTo
    - description: A comma-separated list of IDs of war room entries that contain the files that should be attached to the email.
      isArray: true
      name: attachIDs
    - description: A comma-separated list to rename file-names of corresponding attachments IDs. (e.g. rename first two files - attachNames=file_name1,file_name2. rename first and third file - attachNames=file_name1,,file_name3).
      isArray: true
      name: attachNames
    - description: A comma-separated list of CIDs to embed attachments inside the email itself.
      isArray: true
      name: attachCIDs
    - description: Desired name for attached file. Multiple files are supported as comma-separated list. (e.g. transientFile="t1.txt,temp.txt,t3.txt" transientFileContent="test 2,temporary file content,third file content" transientFileCID="t1.txt@xxx.yyy,t2.txt@xxx.zzz").
      isArray: true
      name: transientFile
    - description: Content for attached file. Multiple files are supported as comma-separated list. (e.g. transientFile="t1.txt,temp.txt,t3.txt" transientFileContent="test 2,temporary file content,third file content" transientFileCID="t1.txt@xxx.yyy,t2.txt@xxx.zzz").
      isArray: true
      name: transientFileContent
    - description: CID for attached file if we want it inline. Multiple files are supported as comma-separated list. (e.g. transientFile="t1.txt,temp.txt,t3.txt" transientFileContent="test 2,temporary file content,third file content" transientFileCID="t1.txt@xxx.yyy,t2.txt@xxx.zzz").
      isArray: true
      name: transientFileCID
    - description: 'Replace {varname} variables with values from this argument. Expected values are in the form of a JSON document like {"varname": {"value": "some value", "key": "context key"}}. Each var name can either be provided with the value or a context key to retrieve the value from. Note that only context data is accessible for this argument, while incident fields are not.'
      name: templateParams
    - description: 'A CSV list of additional headers in the format: headerName=headerValue. For example: "headerName1=headerValue1,headerName2=headerValue2".'
      isArray: true
      name: additionalHeader
    - description: Raw email message to send. If provided, all other arguments, but to, cc and bcc, will be ignored.
      name: raw_message
    - auto: PREDEFINED
      defaultValue: Text
      description: Whether message response body type is text or HTML.
      name: bodyType
      predefined:
      - HTML
      - Text
    - description: Indicates whether to render the email body.
      name: renderBody
      auto: PREDEFINED
      predefined:
      - 'true'
      - 'false'
    - description: The sender address to use for the email. If provided, it overrides the default sender address configured in the integration instance.
      name: sender
      required: false
    description: Send an email.
    name: send-mail
  runonce: false
  script: '-'
  type: python
  subtype: python3
  dockerimage: demisto/python3:3.12.13.10404775
tests:
- Mail Sender (New) Test
fromversion: 5.0.0