Service Resource
We are no longer allowing customers to onboard to Notify. We intend to deprecate the Notify product on October 23, 2023. Learn more in our Notify API End of Life Notice. We prepared this Transition Guide to assist in supporting your push notification use cases.
A Service is the top-level scope of all other resources in Notify REST API.
You can create up to 10 Service resources per account and you can use them to:
- Create separate operational environments, such as dev, stage, and prod, all using the same Twilio account.
- Scope access to resources used by the Notify REST API
- Configure different behaviors of a push-notification or messaging service.
If you need more than 10 Service resources for your account, please contact support.
Service properties
| Resource Properties in REST API format | |
|---|---|
sid
|
The unique string that we created to identify the Service resource. |
account_sid
|
The SID of the Account that created the Service resource. |
friendly_name
|
The string that you assigned to describe the resource. |
date_created
|
The date and time in GMT when the resource was created specified in RFC 2822 format. |
date_updated
|
The date and time in GMT when the resource was last updated specified in RFC 2822 format. |
apn_credential_sid
|
The SID of the Credential to use for APN Bindings. |
gcm_credential_sid
|
The SID of the Credential to use for GCM Bindings. |
fcm_credential_sid
|
The SID of the Credential to use for FCM Bindings. |
messaging_service_sid
|
The SID of the Messaging Service to use for SMS Bindings. In order to send SMS notifications this parameter has to be set. |
facebook_messenger_page_id
|
Deprecated. |
default_apn_notification_protocol_version
|
The protocol version to use for sending APNS notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
default_gcm_notification_protocol_version
|
The protocol version to use for sending GCM notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
default_fcm_notification_protocol_version
|
The protocol version to use for sending FCM notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
log_enabled
|
Whether to log notifications. Can be: |
url
|
The absolute URL of the Service resource. |
links
|
The URLs of the Binding, Notification, Segment, and User resources related to the service. |
alexa_skill_id
|
Deprecated. |
default_alexa_notification_protocol_version
|
Deprecated. |
delivery_callback_url
|
URL to send delivery status callback. |
delivery_callback_enabled
|
Callback configuration that enables delivery callbacks, default false |
Create a Service resource
https://notify.twilio.com/v1/Services
Parameters
| Parameters in REST API format | |
|---|---|
friendly_name
Optional
|
A descriptive string that you create to describe the resource. It can be up to 64 characters long. |
apn_credential_sid
Optional
|
The SID of the Credential to use for APN Bindings. |
gcm_credential_sid
Optional
|
The SID of the Credential to use for GCM Bindings. |
messaging_service_sid
Optional
|
The SID of the Messaging Service to use for SMS Bindings. This parameter must be set in order to send SMS notifications. |
facebook_messenger_page_id
Optional
|
Deprecated. |
default_apn_notification_protocol_version
Optional
|
The protocol version to use for sending APNS notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
default_gcm_notification_protocol_version
Optional
|
The protocol version to use for sending GCM notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
fcm_credential_sid
Optional
|
The SID of the Credential to use for FCM Bindings. |
default_fcm_notification_protocol_version
Optional
|
The protocol version to use for sending FCM notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
log_enabled
Optional
|
Whether to log notifications. Can be: |
alexa_skill_id
Optional
|
Deprecated. |
default_alexa_notification_protocol_version
Optional
|
Deprecated. |
delivery_callback_url
Optional
|
URL to send delivery status callback. |
delivery_callback_enabled
Optional
|
Callback configuration that enables delivery callbacks, default false |
Example 1
Fetch a Service resource
https://notify.twilio.com/v1/Services/{Sid}
Parameters
| Parameters in REST API format | |
|---|---|
sid
Path
|
The Twilio-provided string that uniquely identifies the Service resource to fetch. |
Example 1
Read multiple Service resources
https://notify.twilio.com/v1/Services
Parameters
| Parameters in REST API format | |
|---|---|
friendly_name
Optional
|
The string that identifies the Service resources to read. |
Example 1
Update a Service resource
https://notify.twilio.com/v1/Services/{Sid}
Parameters
| Parameters in REST API format | |
|---|---|
sid
Path
|
The Twilio-provided string that uniquely identifies the Service resource to update. |
friendly_name
Optional
|
A descriptive string that you create to describe the resource. It can be up to 64 characters long. |
apn_credential_sid
Optional
|
The SID of the Credential to use for APN Bindings. |
gcm_credential_sid
Optional
|
The SID of the Credential to use for GCM Bindings. |
messaging_service_sid
Optional
|
The SID of the Messaging Service to use for SMS Bindings. This parameter must be set in order to send SMS notifications. |
facebook_messenger_page_id
Optional
|
Deprecated. |
default_apn_notification_protocol_version
Optional
|
The protocol version to use for sending APNS notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
default_gcm_notification_protocol_version
Optional
|
The protocol version to use for sending GCM notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
fcm_credential_sid
Optional
|
The SID of the Credential to use for FCM Bindings. |
default_fcm_notification_protocol_version
Optional
|
The protocol version to use for sending FCM notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
log_enabled
Optional
|
Whether to log notifications. Can be: |
alexa_skill_id
Optional
|
Deprecated. |
default_alexa_notification_protocol_version
Optional
|
Deprecated. |
delivery_callback_url
Optional
|
URL to send delivery status callback. |
delivery_callback_enabled
Optional
|
Callback configuration that enables delivery callbacks, default false |
Example 1
Delete a Service resource
https://notify.twilio.com/v1/Services/{Sid}
Parameters
| Parameters in REST API format | |
|---|---|
sid
Path
|
The Twilio-provided string that uniquely identifies the Service resource to delete. |
Example 1
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.
