---
title: "Create Org Connector"
method: POST
path: "/internal/v3/integrations/org_connectors"
tags: ["integrations-v3"]
---

# Create Org Connector

`POST /internal/v3/integrations/org_connectors`

Create a new OrgConnector for an organization.

**Permissions**: platform admin only.

Returns HTTP 201 with the created connector.

## Request body

- CreateOrgConnectorRequest
  - `organization_id` string, required — Organization ID that owns the connector
  - `name` string, required — Name of network of which the connector tunnels through. Should be a name that makes sense to the customer 'eg: XCorp VPN, XCorp k8` (unique per organization)
  - `url` string, required — Controller URL from inside the k8s cluster
  - `description` string, nullable — Optional description

## Response `201`

Successful Response

- TraversalDaosOrgConnectorsDaoOrgConnector
  - `id` string, required
  - `organization_id` string, required
  - `kind` 'LEGACY' | 'SELF_SERVE', required
  - `state` 'ACTIVE' | 'DELETED', required
  - `name` string, required
  - `url` string, required — URL of the Edge Controller this connector's tunnel routes through (not the customer connector itself, which is outbound-only and has no reachable address)
  - `description` string, nullable, required
  - `created_at` string, date-time, required

## Other responses

- `422` — Validation Error

## Changes

> 23 revisions in range; 6 not diffed.

- **2026-08-28** `6bbc7dd4088c` — 2 info
  - added the required property `kind` to the response with the `201` status
  - added the required property `state` to the response with the `201` status

[Change history](https://skmtc.dev/traversal/apis/fastapi/changes/internal/v3/integrations/org_connectors/post.md)

---

[API](https://skmtc.dev/traversal/apis/fastapi.md) · [All operations](https://skmtc.dev/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/8e5040513836/schema)