---
title: "POST /v1/Services"
method: POST
path: "/v1/Services"
tags: ["MessagingV1Service"]
---

# POST /v1/Services

`POST /v1/Services`

## Response `201`

Created

- MessagingV1Service
  - `sid` string, nullable — The unique string that we created to identify the Service resource.
  - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Service resource.
  - `friendly_name` string, nullable — The string that you assigned to describe the resource.
  - `date_created` string, date-time, nullable — The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `date_updated` string, date-time, nullable — The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `inbound_request_url` string, uri, nullable — The URL we call using `inbound_method` when a message is received by any phone number or short code in the Service. When this property is `null`, receiving inbound messages is disabled. All messages sent to the Twilio phone number or short code will not be logged and received on the Account. If the `use_inbound_webhook_on_number` field is enabled then the webhook url defined on the phone number will override the `inbound_request_url` defined for the Messaging Service.
  - `inbound_method` 'GET' | 'POST', http-method, nullable — The HTTP method we use to call `inbound_request_url`. Can be `GET` or `POST`.
  - `fallback_url` string, uri, nullable — The URL that we call using `fallback_method` if an error occurs while retrieving or executing the TwiML from the Inbound Request URL. If the `use_inbound_webhook_on_number` field is enabled then the webhook url defined on the phone number will override the `fallback_url` defined for the Messaging Service.
  - `fallback_method` 'GET' | 'POST', http-method, nullable — The HTTP method we use to call `fallback_url`. Can be: `GET` or `POST`.
  - `status_callback` string, uri, nullable — The URL we call to [pass status updates](https://www.twilio.com/docs/sms/api/message-resource#message-status-values) about message delivery.
  - `sticky_sender` boolean, nullable — Whether to enable [Sticky Sender](https://www.twilio.com/docs/messaging/services#sticky-sender) on the Service instance.
  - `mms_converter` boolean, nullable — Whether to enable the [MMS Converter](https://www.twilio.com/docs/messaging/services#mms-converter) for messages sent through the Service instance.
  - `smart_encoding` boolean, nullable — Whether to enable [Smart Encoding](https://www.twilio.com/docs/messaging/services#smart-encoding) for messages sent through the Service instance.
  - `scan_message_content` 'inherit' | 'enable' | 'disable' — Reserved.
  - `fallback_to_long_code` boolean, nullable — [OBSOLETE] Former feature used to fallback to long code sender after certain short code message failures.
  - `area_code_geomatch` boolean, nullable — Whether to enable [Area Code Geomatch](https://www.twilio.com/docs/messaging/services#area-code-geomatch) on the Service Instance.
  - `synchronous_validation` boolean, nullable — Reserved.
  - `validity_period` integer — How long, in seconds, messages sent from the Service are valid. Can be an integer from `1` to `36,000`. Default value is `36,000`.
  - `url` string, uri, nullable — The absolute URL of the Service resource.
  - `links` object, nullable — The absolute URLs of related resources.
  - `usecase` string, nullable — A string that describes the scenario in which the Messaging Service will be used. Possible values are `notifications`, `marketing`, `verification`, `discussion`, `poll`, `undeclared`.
  - `us_app_to_person_registered` boolean, nullable — Whether US A2P campaign is registered for this Service.
  - `use_inbound_webhook_on_number` boolean, nullable — A boolean value that indicates either the webhook url configured on the phone number will be used or `inbound_request_url`/`fallback_url` url will be called when a message is received from the phone number. If this field is enabled then the webhook url defined on the phone number will override the `inbound_request_url`/`fallback_url` defined for the Messaging Service.

## Changes

- **2024-08-26** (v1) `9c7bdebb1c4b` — 1 info
  - the `validity_period` response's property default value `0` was added for the status `201`
- **2024-05-24** (v1) `99116c0327cb` — 1 warning
  - removed the optional property `sending_windows` from the response with the `201` status
- **2024-04-18** (v1) `88bdad18669e` — 8 breaking, 8 info
  - removed the enum value `DELETE` of the request property `FallbackMethod`
  - removed the enum value `DELETE` of the request property `InboundMethod`
  - removed the enum value `HEAD` of the request property `FallbackMethod`
  - removed the enum value `HEAD` of the request property `InboundMethod`
  - …12 more
- **2024-04-04** (v1) `55d8cb83916f` — 1 info
  - added the optional property `sending_windows` to the response with the `201` status
- **2023-08-10** (v1) `8faf72964735` — 1 info
  - api tag `MessagingV1Service` added

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

---

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