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

# Create Org Connector

`POST /internal/v3/integrations/org_connectors`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/internal/v3/integrations/org_connectors`
- Auth: none declared

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

- OrgConnector
  - `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
  - `last_connected_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

## Changes

> 66 revisions in range; 9 not diffed.

- **2026-10-01** `0fb124422604`: 1 info
  - added the optional property `last_connected_at` to the response with the `201` status
- **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

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

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)