# Create service

**POST /v1/Services**


A Messaging Service resource to create, fetch, update, delete or add/remove senders from Messaging Services.

## Servers



## Parameters



### Body:  (object)

- **AreaCodeGeomatch** (boolean)
  Whether to enable [Area Code Geomatch](https://www.twilio.com/docs/sms/services#area-code-geomatch) on the Service Instance.
- **FallbackMethod** (string(http-method))
  The HTTP method we should use to call `fallback_url`. Can be: `GET` or `POST`.
- **FallbackToLongCode** (boolean)
  Whether to enable [Fallback to Long Code](https://www.twilio.com/docs/sms/services#fallback-to-long-code) for messages sent through the Service instance.
- **FallbackUrl** (string(uri))
  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.
- **FriendlyName** (string)
  A descriptive string that you create to describe the resource. It can be up to 64 characters long.
- **InboundMethod** (string(http-method))
  The HTTP method we should use to call `inbound_request_url`. Can be `GET` or `POST` and the default is `POST`.
- **InboundRequestUrl** (string(uri))
  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.
- **MmsConverter** (boolean)
  Whether to enable the [MMS Converter](https://www.twilio.com/docs/sms/services#mms-converter) for messages sent through the Service instance.
- **ScanMessageContent** (string)
  Reserved.
- **SmartEncoding** (boolean)
  Whether to enable [Smart Encoding](https://www.twilio.com/docs/sms/services#smart-encoding) for messages sent through the Service instance.
- **StatusCallback** (string(uri))
  The URL we should call to [pass status updates](https://www.twilio.com/docs/sms/api/message-resource#message-status-values) about message delivery.
- **StickySender** (boolean)
  Whether to enable [Sticky Sender](https://www.twilio.com/docs/sms/services#sticky-sender) on the Service instance.
- **SynchronousValidation** (boolean)
  Reserved.
- **UseInboundWebhookOnNumber** (boolean)
  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.
- **Usecase** (string)
  A string that describes the scenario in which the Messaging Service will be used. Examples: [notification, marketing, verification, poll ..].
- **ValidityPeriod** (integer)
  How long, in seconds, messages sent from the Service are valid. Can be an integer from `1` to `14,400`.


## Responses
### 201
Created

#### Body:  (object)
- **account_sid** (string | null)
  The SID of the Account that created the resource
- **area_code_geomatch** (boolean | null)
  Whether to enable Area Code Geomatch on the Service Instance
- **date_created** (string(date-time) | null)
  The ISO 8601 date and time in GMT when the resource was created
- **date_updated** (string(date-time) | null)
  The ISO 8601 date and time in GMT when the resource was last updated
- **fallback_method** (string(http-method) | null)
  The HTTP method we use to call fallback_url
- **fallback_to_long_code** (boolean | null)
  Whether to enable Fallback to Long Code for messages sent through the Service instance
- **fallback_url** (string(uri) | null)
  The URL that we call using fallback_method if an error occurs while retrieving or executing the TwiML from the Inbound Request URL. This field will be overridden if the `use_inbound_webhook_on_number` field is enabled.
- **friendly_name** (string | null)
  The string that you assigned to describe the resource
- **inbound_method** (string(http-method) | null)
  The HTTP method we use to call inbound_request_url
- **inbound_request_url** (string(uri) | null)
  The URL we call using inbound_method when a message is received by any phone number or short code in the Service. This field will be overridden if the `use_inbound_webhook_on_number` field is enabled.
- **links** (object(uri-map) | null)
  The absolute URLs of related resources
- **mms_converter** (boolean | null)
  Whether to enable the MMS Converter for messages sent through the Service instance
- **scan_message_content** (string | null)
  Reserved
- **sid** (string | null)
  The unique string that identifies the resource
- **smart_encoding** (boolean | null)
  Whether to enable Encoding for messages sent through the Service instance
- **status_callback** (string(uri) | null)
  The URL we call to pass status updates about message delivery
- **sticky_sender** (boolean | null)
  Whether to enable Sticky Sender on the Service instance
- **synchronous_validation** (boolean | null)
  Reserved
- **url** (string(uri) | null)
  The absolute URL of the Service resource
- **us_app_to_person_registered** (boolean | null)
  Whether US A2P campaign is registered for this Service.
- **use_inbound_webhook_on_number** (boolean | null)
  If enabled, the webhook url configured on the phone number will be used and will override the `inbound_request_url`/`fallback_url` url called when an inbound message is received.
- **usecase** (string | null)
  A string describing the scenario in which the Messaging Service will be used
- **validity_period** (integer | null)
  How long, in seconds, messages sent from the Service are valid


[Powered by Bump.sh](https://bump.sh)