twilio-api-sdk 1.0.0

data/lib/twilio_ap_is/apis/notify_v1_binding_api.rb

@@ -0,0 +1,186 @@
+# twilio_ap_is
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module TwilioApIs
+  # NotifyV1BindingApi
+  class NotifyV1BindingApi < BaseApi
+    # TODO: type endpoint description here
+    # @param [String] service_sid Required parameter: The SID of the
+    # [Service](https://www.twilio.com/docs/notify/api/service-resource) to
+    # fetch the resource from.
+    # @param [String] sid Required parameter: The Twilio-provided string that
+    # uniquely identifies the Binding resource to fetch.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def fetch_binding(service_sid,
+                      sid)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/v1/Services/{ServiceSid}/Bindings/{Sid}',
+                                     Server::DEFAULT3)
+                   .template_param(new_parameter(service_sid, key: 'ServiceSid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .template_param(new_parameter(sid, key: 'Sid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(Binding.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+
+    # TODO: type endpoint description here
+    # @param [String] service_sid Required parameter: The SID of the
+    # [Service](https://www.twilio.com/docs/notify/api/service-resource) to
+    # delete the resource from.
+    # @param [String] sid Required parameter: The Twilio-provided string that
+    # uniquely identifies the Binding resource to delete.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def delete_binding(service_sid,
+                       sid)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::DELETE,
+                                     '/v1/Services/{ServiceSid}/Bindings/{Sid}',
+                                     Server::DEFAULT3)
+                   .template_param(new_parameter(service_sid, key: 'ServiceSid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .template_param(new_parameter(sid, key: 'Sid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .is_response_void(true)
+                    .is_api_response(true))
+        .execute
+    end
+
+    # TODO: type endpoint description here
+    # @param [String] service_sid Required parameter: The SID of the
+    # [Service](https://www.twilio.com/docs/notify/api/service-resource) to
+    # create the resource under.
+    # @param [String] identity Required parameter: The `identity` value that
+    # uniquely identifies the new resource's
+    # [User](https://www.twilio.com/docs/chat/rest/user-resource) within the
+    # [Service](https://www.twilio.com/docs/notify/api/service-resource). Up to
+    # 20 Bindings can be created for the same Identity in a given Service.
+    # @param [BindingBindingType] binding_type Required parameter: The transport
+    # technology to use for the Binding. Can be: `apn`, `fcm`, `gcm`, `sms`, or
+    # `facebook-messenger`.
+    # @param [String] address Required parameter: The channel-specific address.
+    # For APNS, the device token. For FCM and GCM, the registration token. For
+    # SMS, a phone number in E.164 format. For Facebook Messenger, the Messenger
+    # ID of the user or a phone number in E.164 format.
+    # @param [Array[String]] tag Optional parameter: A tag that can be used to
+    # select the Bindings to notify. Repeat this parameter to specify more than
+    # one tag, up to a total of 20 tags.
+    # @param [String] notification_protocol_version Optional parameter: The
+    # protocol version to use to send the notification. This defaults to the
+    # value of `default_xxxx_notification_protocol_version` for the protocol in
+    # the [Service](https://www.twilio.com/docs/notify/api/service-resource).
+    # The current version is `"3"` for `apn`, `fcm`, and `gcm` type Bindings.
+    # The parameter is not applicable to `sms` and `facebook-messenger` type
+    # Bindings as the data format is fixed.
+    # @param [String] credential_sid Optional parameter: The SID of the
+    # [Credential](https://www.twilio.com/docs/notify/api/credential-resource)
+    # resource to be used to send notifications to this Binding. If present,
+    # this overrides the Credential specified in the Service resource. Applies
+    # to only `apn`, `fcm`, and `gcm` type Bindings.
+    # @param [String] endpoint Optional parameter: Deprecated.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def create_binding(service_sid,
+                       identity,
+                       binding_type,
+                       address,
+                       tag: nil,
+                       notification_protocol_version: nil,
+                       credential_sid: nil,
+                       endpoint: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v1/Services/{ServiceSid}/Bindings',
+                                     Server::DEFAULT3)
+                   .template_param(new_parameter(service_sid, key: 'ServiceSid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .form_param(new_parameter(identity, key: 'Identity')
+                                .is_required(true))
+                   .form_param(new_parameter(binding_type, key: 'BindingType')
+                                .is_required(true))
+                   .form_param(new_parameter(address, key: 'Address')
+                                .is_required(true))
+                   .form_param(new_parameter(tag, key: 'Tag'))
+                   .form_param(new_parameter(notification_protocol_version, key: 'NotificationProtocolVersion'))
+                   .form_param(new_parameter(credential_sid, key: 'CredentialSid'))
+                   .form_param(new_parameter(endpoint, key: 'Endpoint'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(Binding.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+
+    # TODO: type endpoint description here
+    # @param [String] service_sid Required parameter: The SID of the
+    # [Service](https://www.twilio.com/docs/notify/api/service-resource) to read
+    # the resource from.
+    # @param [Date] start_date Optional parameter: Only include usage that has
+    # occurred on or after this date. Specify the date in GMT and format as
+    # `YYYY-MM-DD`.
+    # @param [Date] end_date Optional parameter: Only include usage that
+    # occurred on or before this date. Specify the date in GMT and format as
+    # `YYYY-MM-DD`.
+    # @param [Array[String]] identity Optional parameter: The
+    # [User](https://www.twilio.com/docs/chat/rest/user-resource)'s `identity`
+    # value of the resources to read.
+    # @param [Array[String]] tag Optional parameter: Only list Bindings that
+    # have all of the specified Tags. The following implicit tags are available:
+    # `all`, `apn`, `fcm`, `gcm`, `sms`, `facebook-messenger`. Up to 5 tags are
+    # allowed.
+    # @param [Integer] page_size Optional parameter: How many resources to
+    # return in each list page. The default is 50, and the maximum is 1000.
+    # @param [Integer] page Optional parameter: The page index. This value is
+    # simply for client state.
+    # @param [String] page_token Optional parameter: The page token. This is
+    # provided by the API.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def list_binding(service_sid,
+                     start_date: nil,
+                     end_date: nil,
+                     identity: nil,
+                     tag: nil,
+                     page_size: nil,
+                     page: nil,
+                     page_token: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/v1/Services/{ServiceSid}/Bindings',
+                                     Server::DEFAULT3)
+                   .template_param(new_parameter(service_sid, key: 'ServiceSid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .query_param(new_parameter(start_date, key: 'StartDate'))
+                   .query_param(new_parameter(end_date, key: 'EndDate'))
+                   .query_param(new_parameter(identity, key: 'Identity'))
+                   .query_param(new_parameter(tag, key: 'Tag'))
+                   .query_param(new_parameter(page_size, key: 'PageSize'))
+                   .query_param(new_parameter(page, key: 'Page'))
+                   .query_param(new_parameter(page_token, key: 'PageToken'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ListBindingResponse.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+  end
+end

data/lib/twilio_ap_is/apis/notify_v1_credential_api.rb

@@ -0,0 +1,183 @@
+# twilio_ap_is
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module TwilioApIs
+  # NotifyV1CredentialApi
+  class NotifyV1CredentialApi < BaseApi
+    # TODO: type endpoint description here
+    # @param [Integer] page_size Optional parameter: How many resources to
+    # return in each list page. The default is 50, and the maximum is 1000.
+    # @param [Integer] page Optional parameter: The page index. This value is
+    # simply for client state.
+    # @param [String] page_token Optional parameter: The page token. This is
+    # provided by the API.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def list_credential(page_size: nil,
+                        page: nil,
+                        page_token: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/v1/Credentials',
+                                     Server::DEFAULT3)
+                   .query_param(new_parameter(page_size, key: 'PageSize'))
+                   .query_param(new_parameter(page, key: 'Page'))
+                   .query_param(new_parameter(page_token, key: 'PageToken'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ListCredentialResponse.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+
+    # TODO: type endpoint description here
+    # @param [CredentialPushType] type Required parameter: The Credential type.
+    # Can be: `gcm`, `fcm`, or `apn`.
+    # @param [String] friendly_name Optional parameter: A descriptive string
+    # that you create to describe the resource. It can be up to 64 characters
+    # long.
+    # @param [String] certificate Optional parameter: [APN only] The URL-encoded
+    # representation of the certificate. Strip everything outside of the
+    # headers, e.g. `-----BEGIN
+    # CERTIFICATE-----MIIFnTCCBIWgAwIBAgIIAjy9H849+E8wDQYJKoZIhvcNAQEFBQAwgZYxCz
+    # AJBgNV.....A==-----END CERTIFICATE-----`
+    # @param [String] private_key Optional parameter: [APN only] The URL-encoded
+    # representation of the private key. Strip everything outside of the
+    # headers, e.g. `-----BEGIN RSA PRIVATE
+    # KEY-----MIIEpQIBAAKCAQEAuyf/lNrH9ck8DmNyo3fGgvCI1l9s+cmBY3WIz+cUDqmxiieR\n
+    # .-----END RSA PRIVATE KEY-----`
+    # @param [TrueClass | FalseClass] sandbox Optional parameter: [APN only]
+    # Whether to send the credential to sandbox APNs. Can be `true` to send to
+    # sandbox APNs or `false` to send to production.
+    # @param [String] api_key Optional parameter: [GCM only] The `Server key` of
+    # your project from Firebase console under Settings / Cloud messaging.
+    # @param [String] secret Optional parameter: [FCM only] The `Server key` of
+    # your project from Firebase console under Settings / Cloud messaging.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def create_credential(type,
+                          friendly_name: nil,
+                          certificate: nil,
+                          private_key: nil,
+                          sandbox: nil,
+                          api_key: nil,
+                          secret: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v1/Credentials',
+                                     Server::DEFAULT3)
+                   .form_param(new_parameter(type, key: 'Type')
+                                .is_required(true))
+                   .form_param(new_parameter(friendly_name, key: 'FriendlyName'))
+                   .form_param(new_parameter(certificate, key: 'Certificate'))
+                   .form_param(new_parameter(private_key, key: 'PrivateKey'))
+                   .form_param(new_parameter(sandbox, key: 'Sandbox'))
+                   .form_param(new_parameter(api_key, key: 'ApiKey'))
+                   .form_param(new_parameter(secret, key: 'Secret'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(Credential1.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+
+    # TODO: type endpoint description here
+    # @param [String] sid Required parameter: The Twilio-provided string that
+    # uniquely identifies the Credential resource to fetch.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def fetch_credential(sid)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/v1/Credentials/{Sid}',
+                                     Server::DEFAULT3)
+                   .template_param(new_parameter(sid, key: 'Sid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(Credential1.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+
+    # TODO: type endpoint description here
+    # @param [String] sid Required parameter: The Twilio-provided string that
+    # uniquely identifies the Credential resource to update.
+    # @param [String] friendly_name Optional parameter: A descriptive string
+    # that you create to describe the resource. It can be up to 64 characters
+    # long.
+    # @param [String] certificate Optional parameter: [APN only] The URL-encoded
+    # representation of the certificate. Strip everything outside of the
+    # headers, e.g. `-----BEGIN
+    # CERTIFICATE-----MIIFnTCCBIWgAwIBAgIIAjy9H849+E8wDQYJKoZIhvcNAQEFBQAwgZYxCz
+    # AJBgNV.....A==-----END CERTIFICATE-----`
+    # @param [String] private_key Optional parameter: [APN only] The URL-encoded
+    # representation of the private key. Strip everything outside of the
+    # headers, e.g. `-----BEGIN RSA PRIVATE
+    # KEY-----MIIEpQIBAAKCAQEAuyf/lNrH9ck8DmNyo3fGgvCI1l9s+cmBY3WIz+cUDqmxiieR\n
+    # .-----END RSA PRIVATE KEY-----`
+    # @param [TrueClass | FalseClass] sandbox Optional parameter: [APN only]
+    # Whether to send the credential to sandbox APNs. Can be `true` to send to
+    # sandbox APNs or `false` to send to production.
+    # @param [String] api_key Optional parameter: [GCM only] The `Server key` of
+    # your project from Firebase console under Settings / Cloud messaging.
+    # @param [String] secret Optional parameter: [FCM only] The `Server key` of
+    # your project from Firebase console under Settings / Cloud messaging.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def update_credential(sid,
+                          friendly_name: nil,
+                          certificate: nil,
+                          private_key: nil,
+                          sandbox: nil,
+                          api_key: nil,
+                          secret: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v1/Credentials/{Sid}',
+                                     Server::DEFAULT3)
+                   .template_param(new_parameter(sid, key: 'Sid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .form_param(new_parameter(friendly_name, key: 'FriendlyName'))
+                   .form_param(new_parameter(certificate, key: 'Certificate'))
+                   .form_param(new_parameter(private_key, key: 'PrivateKey'))
+                   .form_param(new_parameter(sandbox, key: 'Sandbox'))
+                   .form_param(new_parameter(api_key, key: 'ApiKey'))
+                   .form_param(new_parameter(secret, key: 'Secret'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(Credential1.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+
+    # TODO: type endpoint description here
+    # @param [String] sid Required parameter: The Twilio-provided string that
+    # uniquely identifies the Credential resource to delete.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def delete_credential(sid)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::DELETE,
+                                     '/v1/Credentials/{Sid}',
+                                     Server::DEFAULT3)
+                   .template_param(new_parameter(sid, key: 'Sid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .is_response_void(true)
+                    .is_api_response(true))
+        .execute
+    end
+  end
+end

data/lib/twilio_ap_is/apis/notify_v1_notification_api.rb

@@ -0,0 +1,174 @@
+# twilio_ap_is
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module TwilioApIs
+  # NotifyV1NotificationApi
+  class NotifyV1NotificationApi < BaseApi
+    # TODO: type endpoint description here
+    # @param [String] service_sid Required parameter: The SID of the
+    # [Service](https://www.twilio.com/docs/notify/api/service-resource) to
+    # create the resource under.
+    # @param [String] body Optional parameter: The notification text. For FCM
+    # and GCM, translates to `data.twi_body`. For APNS, translates to
+    # `aps.alert.body`. For SMS, translates to `body`. SMS requires either this
+    # `body` value, or `media_urls` attribute defined in the `sms` parameter of
+    # the notification.
+    # @param [NotifPriority] priority Optional parameter: The priority of the
+    # notification. Can be: `low` or `high` and the default is `high`. A value
+    # of `low` optimizes the client app's battery consumption; however,
+    # notifications may be delivered with unspecified delay. For FCM and GCM,
+    # `low` priority is the same as `Normal` priority. For APNS `low` priority
+    # is the same as `5`. A value of `high` sends the notification immediately,
+    # and can wake up a sleeping device. For FCM and GCM, `high` is the same as
+    # `High` priority. For APNS, `high` is a priority `10`. SMS does not support
+    # this property.
+    # @param [Integer] ttl Optional parameter: How long, in seconds, the
+    # notification is valid. Can be an integer between 0 and 2,419,200, which is
+    # 4 weeks, the default and the maximum supported time to live (TTL).
+    # Delivery should be attempted if the device is offline until the TTL
+    # elapses. Zero means that the notification delivery is attempted
+    # immediately, only once, and is not stored for future delivery. SMS does
+    # not support this property.
+    # @param [String] title Optional parameter: The notification title. For FCM
+    # and GCM, this translates to the `data.twi_title` value. For APNS, this
+    # translates to the `aps.alert.title` value. SMS does not support this
+    # property. This field is not visible on iOS phones and tablets but appears
+    # on Apple Watch and Android devices.
+    # @param [String] sound Optional parameter: The name of the sound to be
+    # played for the notification. For FCM and GCM, this Translates to
+    # `data.twi_sound`.  For APNS, this translates to `aps.sound`.  SMS does not
+    # support this property.
+    # @param [String] action Optional parameter: The actions to display for the
+    # notification. For APNS, translates to the `aps.category` value. For GCM,
+    # translates to the `data.twi_action` value. For SMS, this parameter is not
+    # supported and is omitted from deliveries to those channels.
+    # @param [Object] data Optional parameter: The custom key-value pairs of the
+    # notification's payload. For FCM and GCM, this value translates to `data`
+    # in the FCM and GCM payloads. FCM and GCM [reserve certain
+    # keys](https://firebase.google.com/docs/cloud-messaging/http-server-ref)
+    # that cannot be used in those channels. For APNS, attributes of `data` are
+    # inserted into the APNS payload as custom properties outside of the `aps`
+    # dictionary. In all channels, we reserve keys that start with `twi_` for
+    # future use. Custom keys that start with `twi_` are not allowed and are
+    # rejected as 400 Bad request with no delivery attempted. For SMS, this
+    # parameter is not supported and is omitted from deliveries to those
+    # channels.
+    # @param [Object] apn Optional parameter: The APNS-specific payload that
+    # overrides corresponding attributes in the generic payload for APNS
+    # Bindings. This property maps to the APNS `Payload` item, therefore the
+    # `aps` key must be used to change standard attributes. Adds custom
+    # key-value pairs to the root of the dictionary. See the [APNS
+    # documentation](https://developer.apple.com/library/content/documentation/N
+    # etworkingInternet/Conceptual/RemoteNotificationsPG/CommunicatingwithAPNs.h
+    # tml) for more details. We reserve keys that start with `twi_` for future
+    # use. Custom keys that start with `twi_` are not allowed.
+    # @param [Object] gcm Optional parameter: The GCM-specific payload that
+    # overrides corresponding attributes in the generic payload for GCM
+    # Bindings.  This property maps to the root JSON dictionary. See the [GCM
+    # documentation](https://firebase.google.com/docs/cloud-messaging/http-serve
+    # r-ref) for more details. Target parameters `to`, `registration_ids`, and
+    # `notification_key` are not allowed. We reserve keys that start with `twi_`
+    # for future use. Custom keys that start with `twi_` are not allowed. GCM
+    # also [reserves certain
+    # keys](https://firebase.google.com/docs/cloud-messaging/http-server-ref).
+    # @param [Object] sms Optional parameter: The SMS-specific payload that
+    # overrides corresponding attributes in the generic payload for SMS
+    # Bindings.  Each attribute in this value maps to the corresponding `form`
+    # parameter of the Twilio
+    # [Message](https://www.twilio.com/docs/sms/quickstart) resource.  These
+    # parameters of the Message resource are supported in snake case format:
+    # `body`, `media_urls`, `status_callback`, and `max_price`.  The
+    # `status_callback` parameter overrides the corresponding parameter in the
+    # messaging service, if configured. The `media_urls` property expects a JSON
+    # array.
+    # @param [Object] facebook_messenger Optional parameter: Deprecated.
+    # @param [Object] fcm Optional parameter: The FCM-specific payload that
+    # overrides corresponding attributes in the generic payload for FCM
+    # Bindings. This property maps to the root JSON dictionary. See the [FCM
+    # documentation](https://firebase.google.com/docs/cloud-messaging/http-serve
+    # r-ref#downstream) for more details. Target parameters `to`,
+    # `registration_ids`, `condition`, and `notification_key` are not allowed in
+    # this parameter. We reserve keys that start with `twi_` for future use.
+    # Custom keys that start with `twi_` are not allowed. FCM also [reserves
+    # certain
+    # keys](https://firebase.google.com/docs/cloud-messaging/http-server-ref),
+    # which cannot be used in that channel.
+    # @param [Array[String]] segment Optional parameter: The Segment resource is
+    # deprecated. Use the `tag` parameter, instead.
+    # @param [Object] alexa Optional parameter: Deprecated.
+    # @param [Array[String]] to_binding Optional parameter: The destination
+    # address specified as a JSON string.  Multiple `to_binding` parameters can
+    # be included but the total size of the request entity should not exceed
+    # 1MB. This is typically sufficient for 10,000 phone numbers.
+    # @param [String] delivery_callback_url Optional parameter: URL to send
+    # webhooks.
+    # @param [Array[String]] identity Optional parameter: The `identity` value
+    # that uniquely identifies the new resource's
+    # [User](https://www.twilio.com/docs/chat/rest/user-resource) within the
+    # [Service](https://www.twilio.com/docs/notify/api/service-resource).
+    # Delivery will be attempted only to Bindings with an Identity in this list.
+    # No more than 20 items are allowed in this list.
+    # @param [Array[String]] tag Optional parameter: A tag that selects the
+    # Bindings to notify. Repeat this parameter to specify more than one tag, up
+    # to a total of 5 tags. The implicit tag `all` is available to notify all
+    # Bindings in a Service instance. Similarly, the implicit tags `apn`, `fcm`,
+    # `gcm`, `sms` and `facebook-messenger` are available to notify all Bindings
+    # in a specific channel.
+    # @return [ApiResponse] Complete http response with raw body and status code.
+    def create_notification(service_sid,
+                            body: nil,
+                            priority: nil,
+                            ttl: nil,
+                            title: nil,
+                            sound: nil,
+                            action: nil,
+                            data: nil,
+                            apn: nil,
+                            gcm: nil,
+                            sms: nil,
+                            facebook_messenger: nil,
+                            fcm: nil,
+                            segment: nil,
+                            alexa: nil,
+                            to_binding: nil,
+                            delivery_callback_url: nil,
+                            identity: nil,
+                            tag: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/v1/Services/{ServiceSid}/Notifications',
+                                     Server::DEFAULT3)
+                   .template_param(new_parameter(service_sid, key: 'ServiceSid')
+                                    .is_required(true)
+                                    .should_encode(true))
+                   .form_param(new_parameter(body, key: 'Body'))
+                   .form_param(new_parameter(priority, key: 'Priority'))
+                   .form_param(new_parameter(ttl, key: 'Ttl'))
+                   .form_param(new_parameter(title, key: 'Title'))
+                   .form_param(new_parameter(sound, key: 'Sound'))
+                   .form_param(new_parameter(action, key: 'Action'))
+                   .form_param(new_parameter(data, key: 'Data'))
+                   .form_param(new_parameter(apn, key: 'Apn'))
+                   .form_param(new_parameter(gcm, key: 'Gcm'))
+                   .form_param(new_parameter(sms, key: 'Sms'))
+                   .form_param(new_parameter(facebook_messenger, key: 'FacebookMessenger'))
+                   .form_param(new_parameter(fcm, key: 'Fcm'))
+                   .form_param(new_parameter(segment, key: 'Segment'))
+                   .form_param(new_parameter(alexa, key: 'Alexa'))
+                   .form_param(new_parameter(to_binding, key: 'ToBinding'))
+                   .form_param(new_parameter(delivery_callback_url, key: 'DeliveryCallbackUrl'))
+                   .form_param(new_parameter(identity, key: 'Identity'))
+                   .form_param(new_parameter(tag, key: 'Tag'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('accountSid_authToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(Notification.method(:from_hash))
+                    .is_api_response(true))
+        .execute
+    end
+  end
+end