Objective
This article helps you change a Sync Service's settings its friendly name, webhook URL, access control, and reachability options so that Sync notifies your application the way your integration expects.
Product
Twilio Sync
Environment
Twilio Console
User Account Permission/Role(s) Required
Your user role must allow reading Twilio Sync Services to open the page, and updating them to save changes.
Procedure
- In the Twilio Console, select Builder tools in the left sidebar.
- Select Sync, then Services.
- In the Name column, select the Service you want to configure. The Service opens on its Configure tab.
- Under Properties, review the read-only Service SID, Date created, and Date updated, and edit Friendly name if you want to rename the Service.
- Under Webhooks, enter a Webhook URL the URL Twilio calls when Sync objects are changed. Select Webhooks from REST if you also want the webhook called when the REST API is used to change Sync objects.
- Under Access control, select ACL enabled if token identities must be granted access to Sync objects through permissions before they can use them.
- Under Reachability, select Reachability enabled to have the webhook called when client endpoints connect to or disconnect from Sync. Select Reachability debouncing to delay each disconnect event so that a quick reconnection cancels the webhook call, and set Reachability debouncing window (ms) to control how long Sync waits.
- Select Save changes. The console confirms with "Sync Service updated."
Additional Information
- The reachability debouncing window must be between 1000 and 30000 milliseconds; the default is 5000. A value outside that range blocks the save, and your entry stays in the field so you can correct it.
- The debouncing window is only used while Reachability debouncing is enabled.
- Every setting on this form is sent each time you save, so clearing a checkbox turns that setting off.
- The friendly name can be up to 255 characters, and the webhook URL up to 2048 characters.
- If the Service has a unique name, it is shown as a read-only value. A Service's unique name cannot be changed.
- Turning on ACL enabled is what makes the permissions you grant on Documents, Lists, and Maps take effect. While it is off, those permissions are stored but not enforced.
This content was generated by AI and reviewed, edited, and verified by a human.