---
title: "create a carrier as a service provider"
method: POST
path: "/ServiceProviders/{ServiceProviderSid}/VoipCarriers"
tags: ["Carriers"]
---

# create a carrier as a service provider

`POST /ServiceProviders/{ServiceProviderSid}/VoipCarriers`

<Error>This endpoint is only availble with an Admin or Service Provider API key</Error>

## Request body

- VoipCarrier
  - `service_provider_sid` string, uuid, required
  - `name` string, required
  - `description` string
  - `account_sid` string, uuid
  - `application_sid` string, uuid
  - `e164_leading_plus` boolean
  - `requires_register` boolean
  - `register_username` string
  - `register_sip_realm` string
  - `register_password` string
  - `tech_prefix` string
  - `diversion` string
  - `is_active` boolean
  - `smpp_system_id` string
  - `smpp_password` string
  - `smpp_inbound_system_id` string
  - `smpp_inbound_password` string
  - `smpp_enquire_link_interval` integer
  - `trunk_type` 'static_ip' | 'auth' | 'reg' — The type of trunk to create, see the [guide](/guides/using-the-jambonz-portal/basic-concepts/creating-carriers) for details
  - `inbound_auth_username` string — username for an auth trunk
  - `inbound_auth_password` string — password for an auth trunk

## Response `201`

service provider successfully created

- SuccessfulAdd
  - `sid` string, required

## Other responses

- `404` — service provider not found

## Changes

- **2025-11-08** `cda83ab34ad0` — 2 warning, 1 info
  - the `inbound_auth_password` request property's maxLength was set to `64`
  - the `inbound_auth_username` request property's maxLength was set to `64`
  - added the new optional request property `trunk_type`
- **2025-09-19** `3b6ab0c10627` — 1 breaking, 1 warning
  - added the new required request property `service_provider_sid`
  - removed the request property `voip_carrier_sid`
- **2025-03-06** `d813879165bf` — 1 breaking
  - the `smpp_enquire_link_interval` request property type/format changed from `number`/`integer` to `integer`/``
- **2025-02-12** `087165ecc067` — 2 info
  - api tag `Carriers` added
  - api tag `Service Providers` removed

[Change history](https://skmtc.dev/jambonz/apis/jambonz-api/changes/ServiceProviders/:ServiceProviderSid/VoipCarriers/post.md)

---

[API](https://skmtc.dev/jambonz/apis/jambonz-api.md) · [All operations](https://skmtc.dev/jambonz/apis/jambonz-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jambonz/jambonz-api/revisions/56f317145d23/schema)