Objective

This article helps you add a new item to a Sync List. Items hold the JSON payloads in a List and are the data your subscribed clients actually receive.

Product

Twilio Sync

Environment

Twilio Console

User Account Permission/Role(s) Required

Your user role must allow reading Twilio Sync Services to open the List, and creating them to add an item.

Procedure

1. In the Twilio Console, select Builder tools in the left sidebar.
2. Select Sync, then Services.
3. In the Name column, select the Service that holds the List.
4. Select the Lists tab, then select the List's SID to open it.
5. On the Items tab, select Create new List Item.
6. In Data, enter the JSON object this item should store. This field is required.
7. In Item time to live, optionally enter how long in seconds before this item expires and is deleted. Enter 0 for an item that never expires.
8. In Collection time to live, optionally enter a value in seconds to extend the parent Sync List's expiry.
9. Select Create. The console confirms the item's index and the item appears in the table.

Additional Information

• Data must be valid JSON. If it is not, the form reports "Enter valid JSON." and the item is not created.
• An item payload can be up to 16 KiB serialized as UTF-8.
• Both time-to-live values must be whole numbers of seconds between 0 and 31536000 (one year).
• The item's Index is generated by Twilio and cannot be chosen. Items are ordered by that index.
• Selecting Cancel closes the form without creating anything.

This content was generated by AI and reviewed, edited, and verified by a human.