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

# EmailBison: Create New Reply

> Reply to an email in EmailBison, with optional attachments, reply-all or a reply template. Includes inputs, outputs, SDK V2 examples, and Deepline cost.

Reply to an email in EmailBison, with optional attachments, reply-all or a reply template.

> [!NOTE]
>
> Tool ID: `emailbison_create_new_reply`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'emailbison_create_new_reply',
  {
    "reply_id": 123,
    "to_emails": [
      {
        "email_address": "jane.doe@example.com"
      }
    ]
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute emailbison_create_new_reply --input '{
  "reply_id": 123,
  "to_emails": [
    {
      "email_address": "jane.doe@example.com"
    }
  ]
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": "example"
}
```

Use `deepline describe emailbison_create_new_reply --json` for the latest machine-readable contract.

## Input reference

This endpoint allows you to reply to an existing email. The user must provide a valid authentication token in the request header to access this endpoint. Please note that if you are sending an array of file attachments, your request must include a header of "Content-Type": "multipart/form-data". Otherwise your file attachments will not be processed.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.reply_id` | `integer` | Yes | — | The ID of the parent reply. |
| `payload.reply_all` | `boolean` | No | — | If set to true, automatically choose the correct sender email, and add the recipients from the original reply. Explicitly passing in `sender_email_id` will overwrite the chosen sender email, and recipients passed in `to_emails` or "cc\_emails" will be appended. |
| `payload.inject_previous_email_body` | `boolean` | No | — | Whether to inject the body of the previous email into this email |
| `payload.message` | `unknown` | No | — | string The contents of the reply |
| `payload.reply_template_id` | `unknown` | No | — | int The reply template ID that you want to use for this reply. |
| `payload.use_dedicated_ips` | `boolean` | No | — | Send using the dedicated campaign IPs instead of the instance IP |
| `payload.sender_email_id` | `unknown` | No | — | integer The ID of the sender email. Not required if `reply_all` is set to true. If `reply_all` is set to true and this parameter is passed, this parameter takes priority. |
| `payload.content_type` | `string` | No | — | Type of the email (html or text) |
| `payload.to_emails` | `array` | Yes | — | Array of people to send this email to. Not required if `reply_all` is set to true. If `reply_all` is set to true and this parameter is passed, the recipients will be appended. Duplicate recipients are ignored. |
| `payload.cc_emails` | `array` | No | — | An array of people to send a copy of this email to (Carbon Copy). If `reply_all` is set to true and this parameter is passed, the recipients will be appended. Duplicate recipients are ignored. |
| `payload.bcc_emails` | `array` | No | — | An array of people to send a blind copy of this email to (Blind Carbon Copy). |
| `payload.attachments` | `array` | No | — | optional Array of multi-part files that you want to attach. Combined max size: 25MB, individual max size: 10MB. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "This endpoint allows you to reply to an existing email. The user must provide a valid authentication token in the request header to access this endpoint. Please note that if you are sending an array of file attachments, your request must include a header of \"Content-Type\": \"multipart/form-data\". Otherwise your file attachments will not be processed.",
    "properties": {
      "reply_id": {
        "type": "integer",
        "description": "The ID of the parent reply."
      },
      "reply_all": {
        "type": "boolean",
        "description": "If set to true, automatically choose the correct sender email, and add the recipients from the original reply. Explicitly passing in `sender_email_id` will overwrite the chosen sender email, and recipients passed in `to_emails` or \"cc_emails\" will be appended."
      },
      "inject_previous_email_body": {
        "type": [
          "boolean",
          "null"
        ],
        "description": "Whether to inject the body of the previous email into this email"
      },
      "message": {
        "description": "string The contents of the reply"
      },
      "reply_template_id": {
        "description": "int The reply template ID that you want to use for this reply."
      },
      "use_dedicated_ips": {
        "type": "boolean",
        "description": "Send using the dedicated campaign IPs instead of the instance IP"
      },
      "sender_email_id": {
        "description": "integer The ID of the sender email. Not required if `reply_all` is set to true. If `reply_all` is set to true and this parameter is passed, this parameter takes priority."
      },
      "content_type": {
        "type": "string",
        "description": "Type of the email (html or text)"
      },
      "to_emails": {
        "type": "array",
        "description": "Array of people to send this email to. Not required if `reply_all` is set to true. If `reply_all` is set to true and this parameter is passed, the recipients will be appended. Duplicate recipients are ignored.",
        "items": {
          "type": "object",
          "properties": {
            "name": {
              "type": [
                "string",
                "null"
              ],
              "description": "Name of the person (can be null)"
            },
            "email_address": {
              "type": "string"
            }
          },
          "required": [
            "email_address"
          ],
          "additionalProperties": false
        }
      },
      "cc_emails": {
        "type": "array",
        "description": "An array of people to send a copy of this email to (Carbon Copy). If `reply_all` is set to true and this parameter is passed, the recipients will be appended. Duplicate recipients are ignored.",
        "items": {
          "type": "object",
          "properties": {
            "name": {
              "type": [
                "string",
                "null"
              ],
              "description": "The name of the person receiving the email (optional)."
            },
            "email_address": {
              "type": "string",
              "description": "The email address of the recipient."
            }
          },
          "required": [
            "email_address"
          ],
          "additionalProperties": false
        }
      },
      "bcc_emails": {
        "type": "array",
        "description": "An array of people to send a blind copy of this email to (Blind Carbon Copy).",
        "items": {
          "type": "object",
          "properties": {
            "name": {
              "type": [
                "string",
                "null"
              ],
              "description": "The name of the person receiving the email (optional)."
            },
            "email_address": {
              "type": "string",
              "description": "The email address of the recipient."
            }
          },
          "required": [
            "email_address"
          ],
          "additionalProperties": false
        }
      },
      "attachments": {
        "type": "array",
        "description": "optional Array of multi-part files that you want to attach. Combined max size: 25MB, individual max size: 10MB.",
        "items": {
          "type": "string"
        }
      }
    },
    "required": [
      "reply_id",
      "to_emails"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `string` | Yes | — | Provider response payload. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "string",
        "description": "Provider response payload."
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [EmailBison provider guide](https://deepline.com/docs/providers/emailbison/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.