---
title: "Create or update incoming auth"
method: PUT
path: "/config/incoming-auth"
tags: ["Configuration"]
---

# Create or update incoming auth

`PUT /config/incoming-auth`

## Request body

- IncomingAuthUpsert
  - `protocol_type` 'smtp' | 'https', required
  - `username` string — SMTP username.
  - `password` string, password — SHA-256 hashed before storage.
  - `api_key` string — For HTTP; hashed before storage.
  - `api_key_id` integer — Reference to `api_keys.id`.
  - `allowed_ips` string — Comma-separated IPs or `*`.
  - `allowed_domains` string — Comma-separated domains or `*`.

## Response `200`

Incoming auth created or updated.

---

[API](https://skmtc.dev/netcorecloud/apis/email-api-v6.md) · [All operations](https://skmtc.dev/netcorecloud/apis/email-api-v6/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/netcorecloud/email-api-v6/revisions/73f83bc2eff8/schema)