---
title: "Save a SMTP integration"
method: PUT
path: "/integrations/smtp"
tags: ["smtp", "channel/email"]
---

# Save a SMTP integration

`PUT /integrations/smtp`

Updates or creates the SMTP integration for the project.

## Request body

- SMTPConfig
  - `from` object, required — Default sender email address
    - `email` string, email, required — Sender email address
    - `name` string — Sender name
  - `host` string, required — SMTP server hostname
  - `password` string, required — SMTP authentication password
  - `port` integer, required — SMTP server port
  - `reply_to` object — Reply-to email address
    - `email` string, email, required — Reply-to email address
    - `name` string — Reply-to name
  - `security` 'none' | 'ssl' | 'starttls' — SMTP security/encryption method
  - `username` string, required — SMTP authentication username

## Response `200`

OK

- SMTPConfig
  - `from` object, required — Default sender email address
    - `email` string, email, required — Sender email address
    - `name` string — Sender name
  - `host` string, required — SMTP server hostname
  - `password` string, required — SMTP authentication password
  - `port` integer, required — SMTP server port
  - `reply_to` object — Reply-to email address
    - `email` string, email, required — Reply-to email address
    - `name` string — Reply-to name
  - `security` 'none' | 'ssl' | 'starttls' — SMTP security/encryption method
  - `username` string, required — SMTP authentication username

---

[API](https://skmtc.net/magicbell/apis/magicbell-api.md) · [All operations](https://skmtc.net/magicbell/apis/magicbell-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/magicbell/magicbell-api/revisions/8b99dca11019/schema)