---
title: "POST /v1/sipteleport"
method: POST
path: "/v1/sipteleport"
tags: ["SipTeleportService"]
---

# POST /v1/sipteleport

`POST /v1/sipteleport`

## Request

- Base URL: `https://api.subspace.com`
- URL: `https://api.subspace.com/v1/sipteleport`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://id.subspace.com/oauth/token` scopes: `accelerators:read`, `accelerators:write`, `sipteleport:read`, `sipteleport:write`
- TypeScript: <https://skmtc.dev/subspace/apis/subspace-product-api/docs/v1/sipteleport/post.ts> (a function with typed inputs; its response is checked against the schema)

## Headers

- `Idempotency-Key` string, string

## Request body

- V1CreateSipTeleport
  - `name` string, required: Name of SIPTeleport
  - `destination` string, required: Destination of SIPTeleport
  - `status` string: Enum: [ ENABLED, DISABLED ]

## Response `200`

A successful response.

- V1SipTeleportResponse
  - `id` string
  - `name` string
  - `destination` string
  - `teleport_entry_points` V1TeleportAddresses[]
    - `address` string
    - `transport_type` 'UDP_TCP' | 'TLS'
  - `status` 'UNKNOWN' | 'DISABLED' | 'ENABLED'
  - `date_created` string, date-time
  - `date_updated` string, date-time

## Other responses

- `400`: Bad request
- `401`: Access token is missing or invalid
- `402`: Quota exceeded
- `403`: Not authorized
- `404`: Returned when the resource does not exist.
- `429`: Too many client requests
- `default`: An unexpected error response.

## Changes

- **2021-12-22** `87668cb11b8d`: 1 warning, 1 info
  - added the new `UNKNOWN` enum value to the `status` response property for the response status `200`
  - the `status` response's property default value changed from `DISABLED` to `UNKNOWN` for the status `200`
- **2021-10-28** `a1a64afd45aa`: 1 info
  - added the new optional request property `status`
- **2021-10-28** `20391f04dc93`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/subspace/apis/subspace-product-api/changes/v1/sipteleport/post.md)

---

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