Service Resource
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
| Names in PHP format | |
|---|---|
sid
|
The unique string that we created to identify the Service resource. |
accountSid
|
The SID of the Account that created the Service resource. |
friendlyName
|
The string that you assigned to describe the resource. |
dateCreated
|
The date and time in GMT when the resource was created specified in RFC 2822 format. |
dateUpdated
|
The date and time in GMT when the resource was last updated specified in RFC 2822 format. |
apnCredentialSid
|
The SID of the Credential to use for APN Bindings. |
gcmCredentialSid
|
The SID of the Credential to use for GCM Bindings. |
fcmCredentialSid
|
The SID of the Credential to use for FCM Bindings. |
messagingServiceSid
|
The SID of the Messaging Service to use for SMS Bindings. In order to send SMS notifications this parameter has to be set. |
facebookMessengerPageId
|
Deprecated. |
defaultApnNotificationProtocolVersion
|
The protocol version to use for sending APNS notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
defaultGcmNotificationProtocolVersion
|
The protocol version to use for sending GCM notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
defaultFcmNotificationProtocolVersion
|
The protocol version to use for sending FCM notifications. Can be overridden on a Binding by Binding basis when creating a Binding resource. |
logEnabled
|
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. |
alexaSkillId
|
Deprecated. |
defaultAlexaNotificationProtocolVersion
|
Deprecated. |
Create a Service resource
https://notify.twilio.com/v1/Services
Parameters
| Names in None 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. |
Example
Fetch a Service resource
https://notify.twilio.com/v1/Services/{Sid}
Parameters
| Names in None format | |
|---|---|
sid
Required
|
The Twilio-provided string that uniquely identifies the Service resource to fetch. |
Example
Read multiple Service resources
https://notify.twilio.com/v1/Services
Parameters
| Names in None format | |
|---|---|
friendly_name
Optional
|
The string that identifies the Service resources to read. |
Example
Update a Service resource
https://notify.twilio.com/v1/Services/{Sid}
Parameters
| Names in None format | |
|---|---|
sid
Required
|
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. |
Example
Delete a Service resource
https://notify.twilio.com/v1/Services/{Sid}
Parameters
| Names in None format | |
|---|---|
sid
Required
|
The Twilio-provided string that uniquely identifies the Service resource to delete. |
Example
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 browsing the Twilio tag on Stack Overflow.