---
title: "Share a porting order"
method: POST
path: "/porting_orders/{id}/actions/share"
tags: ["Porting Orders"]
---

# Share a porting order

`POST /porting_orders/{id}/actions/share`

Creates a sharing token for a porting order. The token can be used to share the porting order with non-Telnyx users.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `expires_in_seconds` integer — The number of seconds the token will be valid for
  - `permissions` 'porting_order.document.read' | 'porting_order.document.update' — The permissions the token will have

## Response `201`

Successful response

- object
  - `data` PortingOrderSharingToken
    - `id` string, uuid — Uniquely identifies this sharing token
    - `porting_order_id` string, uuid — Identifies the porting order resource being shared
    - `expires_in_seconds` integer — The number of seconds until the sharing token expires
    - `permissions` string[] — The permissions granted to the sharing token
    - `token` string — A signed JWT token that can be used to access the shared resource
    - `expires_at` string, date-time — ISO 8601 formatted date indicating when the sharing token expires.
    - `record_type` string — Identifies the type of the resource.
    - `created_at` string, date-time — ISO 8601 formatted date indicating when the resource was created.

## Other responses

- `401` — Unauthorized
- `404` — Porting Order not found

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)