---
title: "Create an Ip"
method: POST
path: "/ips"
tags: ["IPs"]
---

# Create an Ip

`POST /ips`

Create a new IP object.

## Request body

- CreateIpRequest
  - `connection_id` string — ID of the IP Connection to which this IP should be attached.
  - `ip_address` string, required — IP adddress represented by this resource.
  - `port` integer — Port to use when connecting to this IP.

## Response `201`

Successful response with details about an IP.

- object
  - `data` Ip
    - `id` string — Identifies the type of resource.
    - `record_type` string — Identifies the type of the resource.
    - `connection_id` string — ID of the IP Connection to which this IP should be attached.
    - `ip_address` string — IP adddress represented by this resource.
    - `port` integer — Port to use when connecting to this IP.
    - `created_at` string — ISO 8601 formatted date indicating when the resource was created.
    - `updated_at` string — ISO 8601 formatted date indicating when the resource was updated.

## Other responses

- `401` — Unauthorized
- `403` — The user doesn't have the required permissions to perform the requested action.
- `422` — The request was well-formed but was unable to be followed due to semantic errors.

---

[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)