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

# Create or update incoming auth

`PUT /config/incoming-auth`

## Request

- Base URL: `https://orbitus.netcorecloud.com`
- URL: `https://orbitus.netcorecloud.com/config/incoming-auth`
- Auth: HTTP bearer

## 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/orbit-router.md) - [All operations](https://skmtc.dev/netcorecloud/apis/orbit-router/llms.txt) - [OpenAPI document](https://skmtc.dev/netcorecloud/apis/orbit-router/revisions/680f0a8ab1a3?raw)