---
title: "Register Destination"
method: POST
path: "/pci-proxy/destinations"
---

# Register Destination

`POST /pci-proxy/destinations`

Adds a host to your account's allowlist so the forward proxy can send card data to it. Matching is on the exact hostname, case-insensitive; subdomains and wildcards are not implied. A newly registered host is usable within minutes.

## Request body

- DestinationInput
  - `hostname` string, required — The bare public hostname to allow, without scheme, port, or path (for example `api.example-processor.com`). Matched exactly, case-insensitive.
  - `purpose` string — An optional human-readable label describing why this host is allowed. Shown when you list destinations.
  - `account_id` string, uuid, nullable — Optional. Restrict this destination to a single account (a UUID). Omit (or send `null`) to allow the host for the whole organization.

## Response `201`

The destination was registered.

- Destination
  - `id` string, uuid — Unique identifier of the destination. Use it to remove the destination.
  - `account_id` string, nullable — The account this destination is scoped to, or `null` when it applies to the whole organization.
  - `hostname` string — The registered hostname.
  - `status` 'ENABLED' | 'DISABLED' — Whether the destination is active. Only ENABLED destinations are used by the forward path.
  - `purpose` string — The label you provided when registering the destination.
  - `created_at` string, date-time — When the destination was registered.
  - `updated_at` string, date-time — When the destination was last changed.

## Other responses

- `400` — The request body could not be parsed, or the `account_id` is not a valid account for your organization.
- `401` — Your API credentials are missing or invalid.
- `409` — The hostname is already registered on your allowlist (for this account scope).
- `422` — The hostname is not a bare public hostname (a URL, a host with a scheme, port, or path, an IP address, or a wildcard).

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/versions/05b629819b49/schema)