Skip to content Skip to navigation Skip to topbar

Twilio Docs

Programmable Messaging

Getting Started

Messaging Onboarding Guides

Übersicht 1. SMS Foundations 2. Prepare your sender strategy 3. Build your Account 4. Monitor your application

How to work with your Twilio Free Trial account (US only)How to work with your Twilio Free Trial account (rest of world)Guide to using the Twilio Virtual Phone Messaging Services Quickstart SMS Quickstarts WhatsApp Quickstarts

API Reference

Message Resource

Overview MessageFeedback Resource Media Resource

Service Resource

Service Resource AlphaSender Resource ChannelSender Resource PhoneNumber Resource ShortCode Resource (A2P 10DLC) BrandRegistration Resource (A2P 10DLC) BrandVetting Resource (A2P 10DLC) UsAppToPerson Resource (A2P 10DLC) UsAppToPersonUsecase Resource

Messaging: Country Pricing Resource Deactivations Resource ShortCode Resource

Preventing Fraud

Preventing Fraud in Programmable Messaging SMS Pumping Protection

Tutorials

Receive and Reply to Incoming Messages Send SMS and MMS Messages Send Appointment Reminders Retrieve and Modify Message History Browse all Messaging tutorials

Messaging Services

Overview Send Messages with Messaging Services Manage opt-ins and opt-outs Best Practices for Scaling with Messaging Services Manage queueing and latency Alphanumeric Sender IDs

Messaging Features

Deliverability Score Intelligent Alerts Intelligent Discovery AI Assistant Link Shortening Messaging Logs Message Scheduling

Messaging Insights

Overview Dashboards SMS Pumping Protection Insights

Multi-Tenancy Recommendations SMS Pumping Protection Traffic Shaping

Usage Guides

How to work with your Twilio Free Trial account (US only)How to work with your Twilio Free Trial account (rest of world)Guide to using the Twilio Virtual Phone Preventing Fraud in Programmable Messaging What to Know Before Sending International SMS Messages SMS Geo Permissions Twilio's request to your incoming message Webhook URL Outbound Message Status in Status Callbacks Track the Message Status of Outbound Messages Best Practices for Messaging Delivery Status Logging Safeguard with Message redaction Debugging Common Issues with SMS How to Optimize Message Deliverability with Message Feedback Market Throughput Overview

TwiML

Overview <Message><Redirect>

US A2P 10DLC

US A2P 10DLC Overview Required Business Information Registration for Government and Non-Profit Agencies

Register Your Business

Direct Standard and Low-Volume Standard Registration Direct Sole Proprietor Registration Transition from a Sole Proprietor Brand to a Standard Brand

For ISVs: Register Your Customers

ISV Onboarding Overview Standard and Low-Volume Standard Registration Sole Proprietor Registration Use Externally Registered Campaigns Create Mock Brands and Campaigns

Troubleshooting A2P 10DLC Registrations

Overview Troubleshooting Sole Proprietor Brand Registration Failures Troubleshooting A2P 10DLC Standard/LVS Brands Troubleshooting and rectifying Campaigns Troubleshooting A2P Phone Number registration issues

Set Up Notifications for A2P 10DLC

Toll-Free Verification

Console Onboarding Guide REST API Onboarding Guide

Messaging Channels

Übersicht WhatsApp RCS (Public Beta)Facebook Messenger (Public Beta)Google Business Messages (Public Beta)

Other Messaging products

Content Editor: message templates for any messaging channel Conversations: two-way messaging Verify: user verification and one-time passwords

Related docs

Phone Numbers General Usage Identity and Access Management (IAM)

Messaging
Voice
Serverless
Flex
Studio
All docs...

SDKs
Help

Einloggen
Registrieren Sie sich

Rate this page:

12345

On this page

Messaging Services Resource

Subresources
Resource URI
Service Properties
Create a Service resource
Request body parameters
Fetch a Service resource
Path parameters
Read multiple Service resources
Query parameters
Update a Service resource
Path parameters
Request body parameters
Delete a Service resource
Path parameters

Messaging Services Resource

Service Properties

Create a Service resource

Request body parameters

Fetch a Service resource

Path parameters

Read multiple Service resources

Query parameters

Update a Service resource

Path parameters

Request body parameters

Delete a Service resource

Path parameters

Service Resource

(warning)

Public Beta

The Service Resource is currently available as a Public Beta product. This means that some features for configuring your Messaging Service via the REST API are not yet implemented, and others may be changed before the product is declared Generally Available. Messaging Service Configuration through the Twilio Console is Generally Available.

Public Beta products are not covered by a Twilio SLA.

The resources for sending Messages with a Messaging Service are Generally Available.

When sending a message with a Messaging Service, you can improve message performance by enabling the included features.

Developers can associate phone numbers, short codes, and alpha sender IDs to an instance of a Messaging Service. The Service handles all inbound and outbound behaviors for the phone numbers and shortcodes.

Twilio Console

You can manage your Messaging Services through the Twilio Console when logged in.

Messaging Services Resource

The Services resource of Messaging represents a set of configurable behavior for sending and receiving Messages.

Subresources

The Services resource also has phone numbers, short codes, and alpha sender IDs subresources for managing the phone numbers, short codes, and alpha sender IDs associated with the Service.

Phone Numbers
Short Codes
Alpha Sender IDs

Resource URI

All URLs in this documentation use the following base URL:

https://messaging.twilio.com/v1

Service Properties

Property nameTypeRequiredDescriptionChild properties

sidSID<MG>Optional

The unique string that we created to identify the Service resource.

Pattern: ^MG[0-9a-fA-F]{32}$Min length: 34Max length: 34

account_sidSID<AC>Optional

The SID of the Account that created the Service resource.

Pattern: ^AC[0-9a-fA-F]{32}$Min length: 34Max length: 34

friendly_namestringOptional

The string that you assigned to describe the resource.

date_createdstring<date-time>Optional

The date and time in GMT when the resource was created specified in ISO 8601 format.

date_updatedstring<date-time>Optional

The date and time in GMT when the resource was last updated specified in ISO 8601 format.

inbound_request_urlstring<uri>Optional

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_methodenum<http-method>Optional

The HTTP method we use to call inbound_request_url. Can be GET oder POST.

Possible values:

GETPOST

fallback_urlstring<uri>Optional

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_methodenum<http-method>Optional

The HTTP method we use to call fallback_url. Can be: GET oder POST.

Possible values:

GETPOST

status_callbackstring<uri>Optional

The URL we call to pass status updates about message delivery.

sticky_senderbooleanOptional

Whether to enable Sticky Sender on the Service instance.

mms_converterbooleanOptional

Whether to enable the MMS Converter for messages sent through the Service instance.

smart_encodingbooleanOptional

Whether to enable Smart Encoding for messages sent through the Service instance.

scan_message_contentenum<string>Optional

Reserved.

Possible values:

inheritenabledisable

fallback_to_long_codebooleanOptional

[OBSOLETE] Former feature used to fallback to long code sender after certain short code message failures.

area_code_geomatchbooleanOptional

Whether to enable Area Code Geomatch on the Service Instance.

synchronous_validationbooleanOptional

Reserved.

validity_periodintegerOptional

How long, in seconds, messages sent from the Service are valid. Can be an integer from 1 to 14,400.

Default: 0

urlstring<uri>Optional

The absolute URL of the Service resource.

linksobject<uri-map>Optional

The absolute URLs of related resources.

usecasestringOptional

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_registeredbooleanOptional

Whether US A2P campaign is registered for this Service.

use_inbound_webhook_on_numberbooleanOptional

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.

Create a Service resource

POST https://messaging.twilio.com/v1/Services

Request body parameters

Encoding type:application/x-www-form-urlencoded

SchemaExample

Property nameTypeRequiredDescriptionChild properties

FriendlyNamestringrequired

A descriptive string that you create to describe the resource. It can be up to 64 characters long.

InboundRequestUrlstring<uri>Optional

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.

InboundMethodenum<http-method>Optional

The HTTP method we should use to call inbound_request_url. Can be GET oder POST and the default is POST.

Possible values:

GETPOST

FallbackUrlstring<uri>Optional

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.

FallbackMethodenum<http-method>Optional

The HTTP method we should use to call fallback_url. Can be: GET oder POST.

Possible values:

GETPOST

StatusCallbackstring<uri>Optional

The URL we should call to pass status updates about message delivery.

StickySenderbooleanOptional

Whether to enable Sticky Sender on the Service instance.

MmsConverterbooleanOptional

Whether to enable the MMS Converter for messages sent through the Service instance.

SmartEncodingbooleanOptional

Whether to enable Smart Encoding for messages sent through the Service instance.

ScanMessageContentenum<string>Optional

Reserved.

Possible values:

inheritenabledisable

FallbackToLongCodebooleanOptional

[OBSOLETE] Former feature used to fallback to long code sender after certain short code message failures.

AreaCodeGeomatchbooleanOptional

Whether to enable Area Code Geomatch on the Service Instance.

ValidityPeriodintegerOptional

How long, in seconds, messages sent from the Service are valid. Can be an integer from 1 to 14,400.

SynchronousValidationbooleanOptional

Reserved.

UsecasestringOptional

A string that describes the scenario in which the Messaging Service will be used. Possible values are notifications, marketing, verification, discussion, poll, undeclared.

UseInboundWebhookOnNumberbooleanOptional

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.

{
  "FriendlyName": "My Service!",
  "StickySender": true,
  "MmsConverter": true,
  "SmartEncoding": false,
  "FallbackToLongCode": true,
  "InboundRequestUrl": "https://www.example.com",
  "InboundMethod": "POST",
  "FallbackMethod": "GET",
  "FallbackUrl": "https://www.example.com",
  "StatusCallback": "https://www.example.com",
  "ScanMessageContent": "inherit",
  "AreaCodeGeomatch": true,
  "ValidityPeriod": 600,
  "SynchronousValidation": true,
  "Usecase": "marketing",
  "UseInboundWebhookOnNumber": true
}

Create a Service

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function createService() {
11  const service = await client.messaging.v1.services.create({
12    friendlyName: "FriendlyName",
13  });
14
15  console.log(service.sid);
16}
17
18createService();

Output

1{
2  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
3  "sid": "MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
4  "date_created": "2015-07-30T20:12:31Z",
5  "date_updated": "2015-07-30T20:12:33Z",
6  "friendly_name": "FriendlyName",
7  "inbound_request_url": "https://www.example.com/",
8  "inbound_method": "POST",
9  "fallback_url": "https://www.example.com",
10  "fallback_method": "GET",
11  "status_callback": "https://www.example.com",
12  "sticky_sender": true,
13  "smart_encoding": false,
14  "mms_converter": true,
15  "fallback_to_long_code": true,
16  "scan_message_content": "inherit",
17  "area_code_geomatch": true,
18  "validity_period": 600,
19  "synchronous_validation": true,
20  "usecase": "marketing",
21  "us_app_to_person_registered": false,
22  "use_inbound_webhook_on_number": true,
23  "sending_windows": [],
24  "links": {
25    "phone_numbers": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/PhoneNumbers",
26    "short_codes": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ShortCodes",
27    "alpha_senders": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AlphaSenders",
28    "messages": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages",
29    "us_app_to_person": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Compliance/Usa2p",
30    "us_app_to_person_usecases": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Compliance/Usa2p/Usecases",
31    "channel_senders": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelSenders"
32  },
33  "url": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
34}

Fetch a Service resource

GET https://messaging.twilio.com/v1/Services/{Sid}

Path parameters

Property nameTypeRequiredPIIDescription

SidSID<MG>required

The SID of the Service resource to fetch.

Pattern: ^MG[0-9a-fA-F]{32}$Min length: 34Max length: 34

Fetch a Service

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function fetchService() {
11  const service = await client.messaging.v1
12    .services("MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
13    .fetch();
14
15  console.log(service.sid);
16}
17
18fetchService();

Output

1{
2  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
3  "sid": "MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
4  "date_created": "2015-07-30T20:12:31Z",
5  "date_updated": "2015-07-30T20:12:33Z",
6  "friendly_name": "My Service!",
7  "inbound_request_url": "https://www.example.com/",
8  "inbound_method": "POST",
9  "fallback_url": null,
10  "fallback_method": "POST",
11  "status_callback": "https://www.example.com",
12  "sticky_sender": true,
13  "mms_converter": true,
14  "smart_encoding": false,
15  "fallback_to_long_code": true,
16  "area_code_geomatch": true,
17  "validity_period": 600,
18  "scan_message_content": "inherit",
19  "synchronous_validation": true,
20  "usecase": "marketing",
21  "us_app_to_person_registered": false,
22  "use_inbound_webhook_on_number": true,
23  "sending_windows": [
24    {
25      "start_time": "10:00",
26      "end_time": "21:00"
27    }
28  ],
29  "links": {
30    "phone_numbers": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/PhoneNumbers",
31    "short_codes": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ShortCodes",
32    "alpha_senders": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AlphaSenders",
33    "messages": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages",
34    "us_app_to_person": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Compliance/Usa2p",
35    "us_app_to_person_usecases": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Compliance/Usa2p/Usecases",
36    "channel_senders": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelSenders"
37  },
38  "url": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
39}

Read multiple Service resources

GET https://messaging.twilio.com/v1/Services

Query parameters

Property nameTypeRequiredPIIDescription

PageSizeintegerOptional

How many resources to return in each list page. The default is 50, and the maximum is 1000.

Minimum: 1Maximum: 1000

PageintegerOptional

The page index. This value is simply for client state.

Minimum: 0

PageTokenstringOptional

The page token. This is provided by the API.

List multiple Services

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function listService() {
11  const services = await client.messaging.v1.services.list({ limit: 20 });
12
13  services.forEach((s) => console.log(s.sid));
14}
15
16listService();

Output

1{
2  "meta": {
3    "page": 0,
4    "page_size": 20,
5    "first_page_url": "https://messaging.twilio.com/v1/Services?PageSize=20&Page=0",
6    "previous_page_url": null,
7    "next_page_url": null,
8    "key": "services",
9    "url": "https://messaging.twilio.com/v1/Services?PageSize=20&Page=0"
10  },
11  "services": [
12    {
13      "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
14      "friendly_name": "My Service!",
15      "sid": "MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
16      "date_created": "2015-07-30T20:12:31Z",
17      "date_updated": "2015-07-30T20:12:33Z",
18      "sticky_sender": true,
19      "mms_converter": true,
20      "smart_encoding": false,
21      "fallback_to_long_code": true,
22      "area_code_geomatch": true,
23      "validity_period": 600,
24      "scan_message_content": "inherit",
25      "synchronous_validation": true,
26      "inbound_request_url": "https://www.example.com/",
27      "inbound_method": "POST",
28      "fallback_url": null,
29      "fallback_method": "POST",
30      "status_callback": "https://www.example.com",
31      "usecase": "marketing",
32      "us_app_to_person_registered": false,
33      "use_inbound_webhook_on_number": false,
34      "sending_windows": [
35        {
36          "start_time": "10:00",
37          "end_time": "21:00"
38        }
39      ],
40      "links": {
41        "phone_numbers": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/PhoneNumbers",
42        "short_codes": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ShortCodes",
43        "alpha_senders": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AlphaSenders",
44        "messages": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages",
45        "us_app_to_person": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Compliance/Usa2p",
46        "us_app_to_person_usecases": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Compliance/Usa2p/Usecases",
47        "channel_senders": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelSenders"
48      },
49      "url": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
50    }
51  ]
52}

Update a Service resource

POST https://messaging.twilio.com/v1/Services/{Sid}

You may specify one or more of the optional parameters above to update the Service's respective properties. Parameters not specified in your request are not updated.

Path parameters

Property nameTypeRequiredPIIDescription

SidSID<MG>required

The SID of the Service resource to update.

Pattern: ^MG[0-9a-fA-F]{32}$Min length: 34Max length: 34

Request body parameters

Encoding type:application/x-www-form-urlencoded

SchemaExample

Property nameTypeRequiredDescriptionChild properties

FriendlyNamestringOptional

A descriptive string that you create to describe the resource. It can be up to 64 characters long.

InboundRequestUrlstring<uri>Optional

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.

InboundMethodenum<http-method>Optional

The HTTP method we should use to call inbound_request_url. Can be GET oder POST and the default is POST.

Possible values:

GETPOST

FallbackUrlstring<uri>Optional

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.

FallbackMethodenum<http-method>Optional

The HTTP method we should use to call fallback_url. Can be: GET oder POST.

Possible values:

GETPOST

StatusCallbackstring<uri>Optional

The URL we should call to pass status updates about message delivery.

StickySenderbooleanOptional

Whether to enable Sticky Sender on the Service instance.

MmsConverterbooleanOptional

Whether to enable the MMS Converter for messages sent through the Service instance.

SmartEncodingbooleanOptional

Whether to enable Smart Encoding for messages sent through the Service instance.

ScanMessageContentenum<string>Optional

Reserved.

Possible values:

inheritenabledisable

FallbackToLongCodebooleanOptional

[OBSOLETE] Former feature used to fallback to long code sender after certain short code message failures.

AreaCodeGeomatchbooleanOptional

Whether to enable Area Code Geomatch on the Service Instance.

ValidityPeriodintegerOptional

How long, in seconds, messages sent from the Service are valid. Can be an integer from 1 to 14,400.

SynchronousValidationbooleanOptional

Reserved.

UsecasestringOptional

A string that describes the scenario in which the Messaging Service will be used. Possible values are notifications, marketing, verification, discussion, poll, undeclared.

UseInboundWebhookOnNumberbooleanOptional

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.

{
  "StickySender": false
}

Update a Service

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function updateService() {
11  const service = await client.messaging.v1
12    .services("MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
13    .update({ friendlyName: "FriendlyName" });
14
15  console.log(service.sid);
16}
17
18updateService();

Output

1{
2  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
3  "friendly_name": "FriendlyName",
4  "sid": "MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
5  "date_created": "2015-07-30T20:12:31Z",
6  "date_updated": "2015-07-30T20:12:33Z",
7  "sticky_sender": false,
8  "mms_converter": true,
9  "smart_encoding": false,
10  "fallback_to_long_code": true,
11  "scan_message_content": "inherit",
12  "synchronous_validation": true,
13  "area_code_geomatch": true,
14  "validity_period": 600,
15  "inbound_request_url": "https://www.example.com",
16  "inbound_method": "POST",
17  "fallback_url": null,
18  "fallback_method": "POST",
19  "status_callback": "https://www.example.com",
20  "usecase": "marketing",
21  "us_app_to_person_registered": false,
22  "use_inbound_webhook_on_number": true,
23  "sending_windows": [],
24  "links": {
25    "phone_numbers": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/PhoneNumbers",
26    "short_codes": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ShortCodes",
27    "alpha_senders": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/AlphaSenders",
28    "messages": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Messages",
29    "us_app_to_person": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Compliance/Usa2p",
30    "us_app_to_person_usecases": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Compliance/Usa2p/Usecases",
31    "channel_senders": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/ChannelSenders"
32  },
33  "url": "https://messaging.twilio.com/v1/Services/MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
34}

Delete a Service resource

DELETE https://messaging.twilio.com/v1/Services/{Sid}

When a Service is deleted, all phone numbers and short codes in the Service are returned to your Account.

(warning)

Warning

If you are using a Messaging Service for A2P 10DLC, you should not delete the Messaging Service. Doing so deletes the A2P 10DLC Campaign, which immediately halts all US A2P 10DLC messaging. A new Campaign and Messaging Service must be created and re-registered. This process can take several days.

Path parameters

Property nameTypeRequiredPIIDescription

SidSID<MG>required

The SID of the Service resource to delete.

Pattern: ^MG[0-9a-fA-F]{32}$Min length: 34Max length: 34

Delete a Service

1// Download the helper library from https://www.twilio.com/docs/node/install
2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
3
4// Find your Account SID and Auth Token at twilio.com/console
5// and set the environment variables. See http://twil.io/secure
6const accountSid = process.env.TWILIO_ACCOUNT_SID;
7const authToken = process.env.TWILIO_AUTH_TOKEN;
8const client = twilio(accountSid, authToken);
9
10async function deleteService() {
11  await client.messaging.v1
12    .services("MGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa")
13    .remove();
14}
15
16deleteService();

Rate this page:

12345

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

Terms of service

Datenschutzbestimmungen

Copyright © 2024 Twilio Inc.