---
title: "Create SIP endpoint"
method: POST
path: "/trunks/{sipTrunkId}/endpoints"
tags: ["SIP Endpoints"]
---

# Create SIP endpoint

`POST /trunks/{sipTrunkId}/endpoints`

Create a new SIP endpoint.

## Path parameters

- `sipTrunkId` string, required

## Request body

- union — A SIP endpoint which is the address of your SIP infrastructure. SIP endpoints can be one of two types: static endpoints or registered endpoints. | Endpoint | Description | | -------- | ----------- | | Static endpoints | Static endpoints are defined by a static value which can either be an IP address or a domain name. | | Registered endpoints | Registered endpoints use a credential list to determine the endpoint. | ---
  - object
    - `address` string, required — The address of the SIP endpoint can be an IP address or a domain name. EST uses IP authentication and will only accept calls from the specified address or domain.
    - `port` integer — The port of the SIP endpoint.
    - `id` string — The ID of the SIP endpoint.
    - `sipTrunkId` string — The ID of the SIP trunk to which the endpoint is assigned.
    - `name` string, required — The friendly name of the SIP endpoint.
    - `transport` 'TCP' | 'UDP' | 'TLS' — The transport protocol of the SIP endpoint.
    - `priority` integer, required — Inbound call routing priority. If two or more endpoints have the same priority, calls will be routed to them using a round-robin strategy. Lower priority endpoints will be routed to first. Equal priority endpoints will round-robin calls between them.
    - `enabled` boolean — Sets whether the SIP endpoint is enabled or not.
    - `createTime` string, date-time — The date and time that the SIP endpoint was created.
    - `updateTime` string, date-time — The date and time that the SIP endpoint was last modified.
  - object
    - `isRegistered` boolean, required — This property determines whether the endpoint is static or registered. If registered, this must be set to `true`.
    - `credentialUsername` string, required — The username for the credential list you want to use to register the endpoint.
    - `id` string — The ID of the SIP endpoint.
    - `sipTrunkId` string — The ID of the SIP trunk to which the endpoint is assigned.
    - `name` string, required — The friendly name of the SIP endpoint.
    - `transport` 'TCP' | 'UDP' | 'TLS' — The transport protocol of the SIP endpoint.
    - `priority` integer, required — Inbound call routing priority. If two or more endpoints have the same priority, calls will be routed to them using a round-robin strategy. Lower priority endpoints will be routed to first. Equal priority endpoints will round-robin calls between them.
    - `enabled` boolean — Sets whether the SIP endpoint is enabled or not.
    - `createTime` string, date-time — The date and time that the SIP endpoint was created.
    - `updateTime` string, date-time — The date and time that the SIP endpoint was last modified.

## Response `200`

A successful response.

- object
  - `totalItems` integer — Total size of the result.
  - `pageNumber` string — The token to be used for listing the next page
  - `size` integer — The number of items per page. default is 1000
  - `endpoints` SipEndpoint[]
    - union — A SIP endpoint which is the address of your SIP infrastructure. SIP endpoints can be one of two types: static endpoints or registered endpoints. | Endpoint | Description | | -------- | ----------- | | Static endpoints | Static endpoints are defined by a static value which can either be an IP address or a domain name. | | Registered endpoints | Registered endpoints use a credential list to determine the endpoint. | ---
      - object
        - `address` string, required — The address of the SIP endpoint can be an IP address or a domain name. EST uses IP authentication and will only accept calls from the specified address or domain.
        - `port` integer — The port of the SIP endpoint.
        - `id` string — The ID of the SIP endpoint.
        - `sipTrunkId` string — The ID of the SIP trunk to which the endpoint is assigned.
        - `name` string, required — The friendly name of the SIP endpoint.
        - `transport` 'TCP' | 'UDP' | 'TLS' — The transport protocol of the SIP endpoint.
        - `priority` integer, required — Inbound call routing priority. If two or more endpoints have the same priority, calls will be routed to them using a round-robin strategy. Lower priority endpoints will be routed to first. Equal priority endpoints will round-robin calls between them.
        - `enabled` boolean — Sets whether the SIP endpoint is enabled or not.
        - `createTime` string, date-time — The date and time that the SIP endpoint was created.
        - `updateTime` string, date-time — The date and time that the SIP endpoint was last modified.
      - object
        - `isRegistered` boolean, required — This property determines whether the endpoint is static or registered. If registered, this must be set to `true`.
        - `credentialUsername` string, required — The username for the credential list you want to use to register the endpoint.
        - `id` string — The ID of the SIP endpoint.
        - `sipTrunkId` string — The ID of the SIP trunk to which the endpoint is assigned.
        - `name` string, required — The friendly name of the SIP endpoint.
        - `transport` 'TCP' | 'UDP' | 'TLS' — The transport protocol of the SIP endpoint.
        - `priority` integer, required — Inbound call routing priority. If two or more endpoints have the same priority, calls will be routed to them using a round-robin strategy. Lower priority endpoints will be routed to first. Equal priority endpoints will round-robin calls between them.
        - `enabled` boolean — Sets whether the SIP endpoint is enabled or not.
        - `createTime` string, date-time — The date and time that the SIP endpoint was created.
        - `updateTime` string, date-time — The date and time that the SIP endpoint was last modified.

---

[API](https://skmtc.net/sinch/apis/elastic-sip-trunk-api.md) · [All operations](https://skmtc.net/sinch/apis/elastic-sip-trunk-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/elastic-sip-trunk-api/revisions/c04c2c708bf9/schema)