---
title: "Egress Register"
method: POST
path: "/api/internal/outreach/egress/register"
tags: ["OutreachInternal"]
---

# Egress Register

`POST /api/internal/outreach/egress/register`

Upsert a provisioned egress node + its SOCKS IPs into the inventory. IPs
land ``spare`` (NOT in the send pool); an operator activates them deliberately
via the CLI after the RBL/deliverability check.

## Headers

- `x-internal-token` string, nullable

## Request body

- EgressRegister
  - `node_id` string, required
  - `provider` string, required
  - `ssh_host` string, required
  - `reach` string
  - `tailnet_ip` string, nullable
  - `region` string, nullable
  - `provider_ref` string, nullable
  - `ips` EgressIp[], required
    - `egress_ip` string, required
    - `socks_host` string, required
    - `socks_port` integer, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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