---
title: "Create a new Service for Twilio Proxy"
method: POST
path: "/v1/Services"
tags: ["ProxyV1Service"]
---

# Create a new Service for Twilio Proxy

`POST /v1/Services`

Create a new Service for Twilio Proxy

## Response `201`

Created

- ProxyV1Service
  - `sid` string, nullable — The unique string that we created to identify the Service resource.
  - `unique_name` string, nullable — An application-defined string that uniquely identifies the resource. This value must be 191 characters or fewer in length and be unique. Supports UTF-8 characters. **This value should not have PII.**
  - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Service resource.
  - `chat_instance_sid` string, nullable — The SID of the Chat Service Instance managed by Proxy Service. The Chat Service enables Proxy to forward SMS and channel messages to this chat instance. This is a one-to-one relationship.
  - `callback_url` string, uri, nullable — The URL we call when the interaction status changes.
  - `default_ttl` integer — The default `ttl` value for Sessions created in the Service. The TTL (time to live) is measured in seconds after the Session's last create or last Interaction. The default value of `0` indicates an unlimited Session length. You can override a Session's default TTL value by setting its `ttl` value.
  - `number_selection_behavior` 'avoid-sticky' | 'prefer-sticky' — The preference for Proxy Number selection in the Service instance. Can be: `prefer-sticky` or `avoid-sticky`. `prefer-sticky` means that we will try and select the same Proxy Number for a given participant if they have previous [Sessions](https://www.twilio.com/docs/proxy/api/session), but we will not fail if that Proxy Number cannot be used. `avoid-sticky` means that we will try to use different Proxy Numbers as long as that is possible within a given pool rather than try and use a previously assigned number.
  - `geo_match_level` 'area-code' | 'overlay' | 'radius' | 'country' — Where a proxy number must be located relative to the participant identifier. Can be: `country`, `area-code`, or `extended-area-code`. The default value is `country` and more specific areas than `country` are only available in North America.
  - `intercept_callback_url` string, uri, nullable — The URL we call on each interaction. If we receive a 403 status, we block the interaction; otherwise the interaction continues.
  - `out_of_session_callback_url` string, uri, nullable — The URL we call when an inbound call or SMS action occurs on a closed or non-existent Session. If your server (or a Twilio [function](https://www.twilio.com/en-us/serverless/functions)) responds with valid [TwiML](https://www.twilio.com/docs/voice/twiml), we will process it. This means it is possible, for example, to play a message for a call, send an automated text message response, or redirect a call to another Phone Number. See [Out-of-Session Callback Response Guide](https://www.twilio.com/docs/proxy/out-session-callback-response-guide) for more information.
  - `date_created` string, date-time, nullable — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was created.
  - `date_updated` string, date-time, nullable — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was last updated.
  - `url` string, uri, nullable — The absolute URL of the Service resource.
  - `links` object, nullable — The URLs of resources related to the Service.

## Changes

- **2024-08-26** (v1) `5d96b79babfd` — 1 info
  - the `default_ttl` response's property default value `0` was added for the status `201`
- **2023-08-10** (v1) `6b9a26829560` — 1 info
  - api tag `ProxyV1Service` added

[Change history](https://skmtc.dev/twilio/apis/proxy-v1/changes/v1/Services/post.md)

---

[API](https://skmtc.dev/twilio/apis/proxy-v1.md) · [All operations](https://skmtc.dev/twilio/apis/proxy-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/proxy-v1/revisions/a2e6d27b3ecd/schema)