# Notify API Binding Resource > \[!CAUTION] > > Twilio deprecated Notify in October 2022 and no longer supports it. Learn more about [transitioning off Notify](https://support.twilio.com/hc/en-us/articles/11746930233115-Transitioning-off-Notify). > > If you're starting a new project, use [Programmable Messaging](/docs/messaging) for SMS notifications. For push notifications, integrate directly with platform-specific services such as APNs for iOS or FCM for Android. If you've already built on Notify, visit the [transition guide](https://support.twilio.com/hc/en-us/articles/11746930233115-Transitioning-off-Notify) to learn about your options. The **Binding** resource binds an `identity` to the `address` used by a notification channel. For example, iOS push notifications use an APNS device token for their address and SMS uses a phone number. Creating a Binding allows you to send notifications by referring to an `identity` rather than a specific device. You can create up to 20 Bindings with the same `identity` in a given Service. You can add `tags` to a Binding that describe related Bindings. For example, you can add a tag to the Bindings of a user's preferred devices and then refer to that tag to notify them on only their preferred devices. Read more about [Sending Notifications](/docs/notify/send-notifications). > \[!CAUTION] > > The systems that process this parameter assume it does not contain PII. > > You should use a GUID or other pseudonymized identifier for `identity` instead of PII such as a *person's name, home address, email or phone number.* If you identify your users with PII, we recommend creating a pseudonymized identifier from their PII, for example by hashing or encrypting it, before you use it for `identity`. > > You can read more about how we process your data in our [privacy policy](/en-us/legal/privacy). > \[!WARNING] > > It's a good practice to obtain your end users' consent before you send them messages and some jurisdictions might require it by law. > > *We recommend that you consult with your legal counsel to make sure that your communications comply with all applicable laws.* > > To make sure your messages reach the right people, you should make sure that they have given you their consent to send them messages and that their contact information is current. > > Check out the [Twilio Marketplace for Add-ons](/docs/marketplace) from our partners that can help you keep your database up to date. ## Address for push notifications While the `address` of an SMS message is the phone number, the `address` to use for push notifications is obtained by your client-side mobile app. Learn how to: * [Register for Notifications on iOS](/docs/notify/register-for-notifications-ios) to obtain the APNS address, called a *device token*. * [Register for Notifications on Android](/docs/notify/register-for-notifications-android) to obtain the FCM address, called a *registration token*. ## Binding Properties ```json {"type":"object","refName":"notify.v1.service.binding","modelName":"notify_v1_service_binding","properties":{"sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^BS[0-9a-fA-F]{32}$","nullable":true,"description":"The unique string that we created to identify the Binding resource."},"account_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^AC[0-9a-fA-F]{32}$","nullable":true,"description":"The SID of the [Account](/docs/iam/api/account) that created the Binding resource."},"service_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^IS[0-9a-fA-F]{32}$","nullable":true,"description":"The SID of the [Service](/docs/notify/api/service-resource) the resource is associated with."},"credential_sid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^CR[0-9a-fA-F]{32}$","nullable":true,"description":"The SID of the [Credential](/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. Applicable only to `apn`, `fcm`, and `gcm` type Bindings."},"date_created":{"type":"string","format":"date-time","nullable":true,"description":"The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format."},"date_updated":{"type":"string","format":"date-time","nullable":true,"description":"The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format."},"notification_protocol_version":{"type":"string","nullable":true,"description":"The protocol version to use to send the notification. This defaults to the value of `default_xxxx_notification_protocol_version` in the [Service](/docs/notify/api/service-resource) for the protocol. 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."},"endpoint":{"type":"string","nullable":true,"description":"Deprecated."},"identity":{"type":"string","nullable":true,"description":"The `identity` value that uniquely identifies the resource's [User](/docs/chat/rest/user-resource) within the [Service](/docs/notify/api/service-resource). Up to 20 Bindings can be created for the same Identity in a given Service.","x-twilio":{"pii":{"handling":"standard","deleteSla":120}}},"binding_type":{"type":"string","nullable":true,"description":"The transport technology to use for the Binding. Can be: `apn`, `fcm`, `gcm`, `sms`, or `facebook-messenger`."},"address":{"type":"string","nullable":true,"description":"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.","x-twilio":{"pii":{"handling":"sensitive","deleteSla":120}}},"tags":{"type":"array","nullable":true,"description":"The list of tags associated with this Binding. Tags can be used to select the Bindings to use when sending a notification. Maximum 20 tags are allowed.","x-twilio":{"pii":{"handling":"standard","deleteSla":120}},"items":{"type":"string"}},"url":{"type":"string","format":"uri","nullable":true,"description":"The absolute URL of the Binding resource."},"links":{"type":"object","format":"uri-map","nullable":true,"description":"The URLs of related resources."}}} ``` ### Endpoint (DEPRECATED) We deprecated `endpoint` and trust the push-channel provider (such as APNS or Firebase) to let us know when an app has changed or invalidated the device token used as the `address`. The `endpoint` property was used to uniquely identify push notification Bindings when the app installation's `address` changed, such as when the device token changed in an iOS app. You can still include an `Endpoint` parameter when you create a Binding; however, it will be ignored. ## Create a Binding resource `POST https://notify.twilio.com/v1/Services/{ServiceSid}/Bindings` ### Path parameters ```json [{"name":"ServiceSid","in":"path","description":"The SID of the [Service](/docs/notify/api/service-resource) to create the resource under.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^IS[0-9a-fA-F]{32}$"},"required":true}] ``` ### Request body parameters ```json {"schema":{"type":"object","title":"CreateBindingRequest","required":["Identity","BindingType","Address"],"properties":{"Identity":{"type":"string","description":"The `identity` value that uniquely identifies the new resource's [User](/docs/chat/rest/user-resource) within the [Service](/docs/notify/api/service-resource). Up to 20 Bindings can be created for the same Identity in a given Service.","x-twilio":{"pii":{"handling":"standard","deleteSla":120}}},"BindingType":{"type":"string","enum":["apn","gcm","sms","fcm","facebook-messenger","alexa"],"description":"The transport technology to use for the Binding. Can be: `apn`, `fcm`, `gcm`, `sms`, or `facebook-messenger`.","refName":"binding_enum_binding_type","modelName":"binding_enum_binding_type"},"Address":{"type":"string","description":"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.","x-twilio":{"pii":{"handling":"sensitive","deleteSla":120}}},"Tag":{"type":"array","description":"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.","items":{"type":"string"}},"NotificationProtocolVersion":{"type":"string","description":"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](/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."},"CredentialSid":{"type":"string","minLength":34,"maxLength":34,"pattern":"^CR[0-9a-fA-F]{32}$","description":"The SID of the [Credential](/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."},"Endpoint":{"type":"string","description":"Deprecated."}}},"examples":{"create":{"value":{"lang":"json","value":"{\n \"Address\": \"address\",\n \"BindingType\": \"apn\",\n \"CredentialSid\": \"CRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"Endpoint\": \"endpoint\",\n \"Identity\": \"24987039\",\n \"NotificationProtocolVersion\": \"notification_protocol_version\",\n \"Tag\": [\n \"tag\"\n ]\n}","meta":"","code":"{\n \"Address\": \"address\",\n \"BindingType\": \"apn\",\n \"CredentialSid\": \"CRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n \"Endpoint\": \"endpoint\",\n \"Identity\": \"24987039\",\n \"NotificationProtocolVersion\": \"notification_protocol_version\",\n \"Tag\": [\n \"tag\"\n ]\n}","tokens":[["{","#C9D1D9"],"\n ",["\"Address\"","#7EE787"],[":","#C9D1D9"]," ",["\"address\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"BindingType\"","#7EE787"],[":","#C9D1D9"]," ",["\"apn\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"CredentialSid\"","#7EE787"],[":","#C9D1D9"]," ",["\"CRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"Endpoint\"","#7EE787"],[":","#C9D1D9"]," ",["\"endpoint\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"Identity\"","#7EE787"],[":","#C9D1D9"]," ",["\"24987039\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"NotificationProtocolVersion\"","#7EE787"],[":","#C9D1D9"]," ",["\"notification_protocol_version\"","#A5D6FF"],[",","#C9D1D9"],"\n ",["\"Tag\"","#7EE787"],[": [","#C9D1D9"],"\n ",["\"tag\"","#A5D6FF"],"\n ",["]","#C9D1D9"],"\n",["}","#C9D1D9"]],"annotations":[],"themeName":"github-dark","style":{"color":"#c9d1d9","background":"#0d1117"}}}},"encodingType":"application/x-www-form-urlencoded","conditionalParameterMap":{}} ``` Create a Binding resource ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function createBinding() { const binding = await client.notify.v1 .services("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .bindings.create({ address: "Unit 3856 Box 3973\nDPO AA 31194", bindingType: "apn", identity: "Identity", }); console.log(binding.sid); } createBinding(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ['TWILIO_ACCOUNT_SID'] auth_token = os.environ['TWILIO_AUTH_TOKEN'] client = Client(account_sid, auth_token) binding = client \ .notify \ .v1 \ .services('ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') \ .bindings.create( identity='Identity', binding_type='apn', address='Unit 3856 Box 3973 DPO AA 31194' ) print(binding.sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Notify.V1.Service; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var binding = await BindingResource.CreateAsync( identity: "Identity", bindingType: BindingResource.BindingTypeEnum.Apn, address: "Unit 3856 Box 3973\nDPO AA 31194", pathServiceSid: "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"); Console.WriteLine(binding.Sid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.Twilio; import com.twilio.rest.notify.v1.service.Binding; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); Binding binding = Binding .creator("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "Identity", Binding.BindingType.APN, "Unit 3856 Box 3973\nDPO AA 31194") .create(); System.out.println(binding.getSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" notify "github.com/twilio/twilio-go/rest/notify/v1" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := ¬ify.CreateBindingParams{} params.SetIdentity("Identity") params.SetBindingType("apn") params.SetAddress("Unit 3856 Box 3973\nDPO AA 31194") resp, err := client.NotifyV1.CreateBinding("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.Sid != nil { fmt.Println(*resp.Sid) } else { fmt.Println(resp.Sid) } } } ``` ```php notify->v1 ->services("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") ->bindings->create( "Identity", // Identity "apn", // BindingType "Unit 3856 Box 3973\nDPO AA 31194" // Address ); print $binding->sid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) binding = @client .notify .v1 .services('ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') .bindings .create( identity: 'Identity', binding_type: 'apn', address: 'Unit 3856 Box 3973 DPO AA 31194' ) puts binding.sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:notify:v1:services:bindings:create \ --service-sid ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa \ --identity Identity \ --binding-type apn \ --address "Unit 3856 Box 3973\nDPO AA 31194" ``` ```bash curl -X POST "https://notify.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Bindings" \ --data-urlencode "Identity=Identity" \ --data-urlencode "BindingType=apn" \ --data-urlencode "Address=Unit 3856 Box 3973\nDPO AA 31194" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "address": "Unit 3856 Box 3973\nDPO AA 31194", "binding_type": "apn", "credential_sid": null, "date_created": "2015-07-30T20:00:00Z", "date_updated": "2015-07-30T20:00:00Z", "endpoint": "26607274", "identity": "Identity", "notification_protocol_version": "3", "service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sid": "BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "tags": [ "26607274" ], "links": { "user": "https://notify.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Users/24987039" }, "url": "https://notify.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Bindings/BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" } ``` ## Existing Bindings with the same Address are replaced If the Service already has a Binding with the same `Address` as specified in the create request, the Binding being created replaces the existing Binding. The new Binding replaces the existing one under these conditions to prevent leaking notifications between users when, for example, a new user logs into your app on a device that has already been registered to another user. To register the same address twice, such as when someone is a buyer and a seller at the same time in a marketplace, we recommend creating separate Service instances, such as one for buyers and one for sellers. ## Endpoint (DEPRECATED) We deprecated `endpoint` and trust the push-channel provider (such as APNS or Firebase) to let us know when an app has changed or invalidated the device token used as the `address`. The `endpoint` property was used to uniquely identify push notification Bindings when the app installation's `address` changed, such as when the device token changed in an iOS app. You can still include an `Endpoint` parameter when you create a Binding; however, it will be ignored. ## Fetch a Binding resource `GET https://notify.twilio.com/v1/Services/{ServiceSid}/Bindings/{Sid}` ### Path parameters ```json [{"name":"ServiceSid","in":"path","description":"The SID of the [Service](/docs/notify/api/service-resource) to fetch the resource from.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^IS[0-9a-fA-F]{32}$"},"required":true},{"name":"Sid","in":"path","description":"The Twilio-provided string that uniquely identifies the Binding resource to fetch.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^BS[0-9a-fA-F]{32}$"},"required":true}] ``` Fetch a Binding resource ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function fetchBinding() { const binding = await client.notify.v1 .services("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .bindings("BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .fetch(); console.log(binding.sid); } fetchBinding(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) binding = ( client.notify.v1.services("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .bindings("BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .fetch() ) print(binding.sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Notify.V1.Service; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var binding = await BindingResource.FetchAsync( pathServiceSid: "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", pathSid: "BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"); Console.WriteLine(binding.Sid); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.Twilio; import com.twilio.rest.notify.v1.service.Binding; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); Binding binding = Binding.fetcher("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").fetch(); System.out.println(binding.getSid()); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() resp, err := client.NotifyV1.FetchBinding("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { if resp.Sid != nil { fmt.Println(*resp.Sid) } else { fmt.Println(resp.Sid) } } } ``` ```php notify->v1 ->services("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") ->bindings("BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") ->fetch(); print $binding->sid; ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) binding = @client .notify .v1 .services('ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') .bindings('BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') .fetch puts binding.sid ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:notify:v1:services:bindings:fetch \ --service-sid ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa \ --sid BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa ``` ```bash curl -X GET "https://notify.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Bindings/BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "address": "a7c658f4111ec4ff5a1a647f9d0edd819025b9f20522d2fae897049f32873e73", "binding_type": "apn", "credential_sid": null, "date_created": "2015-07-30T20:00:00Z", "date_updated": "2015-07-30T20:00:00Z", "endpoint": "26607274", "identity": "24987039", "notification_protocol_version": "3", "service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "sid": "BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "tags": [ "26607274" ], "links": { "user": "https://notify.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Users/24987039" }, "url": "https://notify.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Bindings/BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" } ``` ## Read multiple Binding resources `GET https://notify.twilio.com/v1/Services/{ServiceSid}/Bindings` ### Path parameters ```json [{"name":"ServiceSid","in":"path","description":"The SID of the [Service](/docs/notify/api/service-resource) to read the resource from.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^IS[0-9a-fA-F]{32}$"},"required":true}] ``` ### Query parameters ```json [{"name":"StartDate","in":"query","description":"Only include usage that has occurred on or after this date. Specify the date in GMT and format as `YYYY-MM-DD`.","schema":{"type":"string","format":"date"}},{"name":"EndDate","in":"query","description":"Only include usage that occurred on or before this date. Specify the date in GMT and format as `YYYY-MM-DD`.","schema":{"type":"string","format":"date"}},{"name":"Identity","in":"query","description":"The [User](/docs/chat/rest/user-resource)'s `identity` value of the resources to read.","schema":{"type":"array","items":{"type":"string"}},"x-twilio":{"pii":{"handling":"standard","deleteSla":120}},"examples":{"readEmpty":{"value":["identity"]},"readFull":{"value":["identity"]}}},{"name":"Tag","in":"query","description":"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.","schema":{"type":"array","items":{"type":"string"}},"examples":{"readEmpty":{"value":["tag"]},"readFull":{"value":["tag"]}}},{"name":"PageSize","in":"query","description":"How many resources to return in each list page. The default is 50, and the maximum is 1000.","schema":{"type":"integer","format":"int64","minimum":1,"maximum":1000}},{"name":"Page","in":"query","description":"The page index. This value is simply for client state.","schema":{"type":"integer","minimum":0}},{"name":"PageToken","in":"query","description":"The page token. This is provided by the API.","schema":{"type":"string"}}] ``` Read multiple Binding resources ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function listBinding() { const bindings = await client.notify.v1 .services("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .bindings.list({ limit: 20 }); bindings.forEach((b) => console.log(b.sid)); } listBinding(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) bindings = client.notify.v1.services( "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ).bindings.list(limit=20) for record in bindings: print(record.sid) ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Notify.V1.Service; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); var bindings = await BindingResource.ReadAsync( pathServiceSid: "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", limit: 20); foreach (var record in bindings) { Console.WriteLine(record.Sid); } } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.Twilio; import com.twilio.rest.notify.v1.service.Binding; import com.twilio.base.ResourceSet; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); ResourceSet bindings = Binding.reader("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").limit(20).read(); for (Binding record : bindings) { System.out.println(record.getSid()); } } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" notify "github.com/twilio/twilio-go/rest/notify/v1" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() params := ¬ify.ListBindingParams{} params.SetLimit(20) resp, err := client.NotifyV1.ListBinding("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", params) if err != nil { fmt.Println(err.Error()) os.Exit(1) } else { for record := range resp { if resp[record].Sid != nil { fmt.Println(*resp[record].Sid) } else { fmt.Println(resp[record].Sid) } } } } ``` ```php notify->v1 ->services("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") ->bindings->read([], 20); foreach ($bindings as $record) { print $record->sid; } ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) bindings = @client .notify .v1 .services('ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') .bindings .list(limit: 20) bindings.each do |record| puts record.sid end ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:notify:v1:services:bindings:list \ --service-sid ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa ``` ```bash curl -X GET "https://notify.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Bindings?PageSize=20" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ``` ```json { "bindings": [], "meta": { "first_page_url": "https://notify.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Bindings?Tag=tag&Identity=identity&PageSize=50&Page=0", "key": "bindings", "next_page_url": null, "page": 0, "page_size": 50, "previous_page_url": null, "url": "https://notify.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Bindings?Tag=tag&Identity=identity&PageSize=50&Page=0" } } ``` Note that no more than 50 Bindings are returned at a time. ## Delete a Binding resource `DELETE https://notify.twilio.com/v1/Services/{ServiceSid}/Bindings/{Sid}` ### Path parameters ```json [{"name":"ServiceSid","in":"path","description":"The SID of the [Service](/docs/notify/api/service-resource) to delete the resource from.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^IS[0-9a-fA-F]{32}$"},"required":true},{"name":"Sid","in":"path","description":"The Twilio-provided string that uniquely identifies the Binding resource to delete.","schema":{"type":"string","minLength":34,"maxLength":34,"pattern":"^BS[0-9a-fA-F]{32}$"},"required":true}] ``` Delete a Binding resource ```js // Download the helper library from https://www.twilio.com/docs/node/install const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio"; // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure const accountSid = process.env.TWILIO_ACCOUNT_SID; const authToken = process.env.TWILIO_AUTH_TOKEN; const client = twilio(accountSid, authToken); async function deleteBinding() { await client.notify.v1 .services("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .bindings("BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") .remove(); } deleteBinding(); ``` ```python # Download the helper library from https://www.twilio.com/docs/python/install import os from twilio.rest import Client # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = os.environ["TWILIO_ACCOUNT_SID"] auth_token = os.environ["TWILIO_AUTH_TOKEN"] client = Client(account_sid, auth_token) client.notify.v1.services("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").bindings( "BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" ).delete() ``` ```csharp // Install the C# / .NET helper library from twilio.com/docs/csharp/install using System; using Twilio; using Twilio.Rest.Notify.V1.Service; using System.Threading.Tasks; class Program { public static async Task Main(string[] args) { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure string accountSid = Environment.GetEnvironmentVariable("TWILIO_ACCOUNT_SID"); string authToken = Environment.GetEnvironmentVariable("TWILIO_AUTH_TOKEN"); TwilioClient.Init(accountSid, authToken); await BindingResource.DeleteAsync( pathServiceSid: "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", pathSid: "BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"); } } ``` ```java // Install the Java helper library from twilio.com/docs/java/install import com.twilio.Twilio; import com.twilio.rest.notify.v1.service.Binding; public class Example { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure public static final String ACCOUNT_SID = System.getenv("TWILIO_ACCOUNT_SID"); public static final String AUTH_TOKEN = System.getenv("TWILIO_AUTH_TOKEN"); public static void main(String[] args) { Twilio.init(ACCOUNT_SID, AUTH_TOKEN); Binding.deleter("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa").delete(); } } ``` ```go // Download the helper library from https://www.twilio.com/docs/go/install package main import ( "fmt" "github.com/twilio/twilio-go" "os" ) func main() { // Find your Account SID and Auth Token at twilio.com/console // and set the environment variables. See http://twil.io/secure // Make sure TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN exists in your environment client := twilio.NewRestClient() err := client.NotifyV1.DeleteBinding("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") if err != nil { fmt.Println(err.Error()) os.Exit(1) } } ``` ```php notify->v1 ->services("ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") ->bindings("BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa") ->delete(); ``` ```ruby # Download the helper library from https://www.twilio.com/docs/ruby/install require 'twilio-ruby' # Find your Account SID and Auth Token at twilio.com/console # and set the environment variables. See http://twil.io/secure account_sid = ENV['TWILIO_ACCOUNT_SID'] auth_token = ENV['TWILIO_AUTH_TOKEN'] @client = Twilio::REST::Client.new(account_sid, auth_token) @client .notify .v1 .services('ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') .bindings('BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa') .delete ``` ```bash # Install the twilio-cli from https://twil.io/cli twilio api:notify:v1:services:bindings:remove \ --service-sid ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa \ --sid BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa ``` ```bash curl -X DELETE "https://notify.twilio.com/v1/Services/ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Bindings/BSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \ -u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN ```