Alerts - Subscription files



To add this product to your account, contact a Telesign expert. This product is available for full-service accounts only.

This page provides technical details for the subscription files you send to the service to add or remove phone numbers.

SFTP location


your_suborg_idA number from Telesign identifying your organization.



File naming convention


timestampThe date and time when the file was created. The timestamp should be in ISO-8601 format, with no milliseconds included, no special characters included, and "Z" included at the end. The timestamp must be no older than seven days.





You must name your subscription files according to this convention. Files with invalid names are rejected by the service.


Each record in this file initiates an action to subscribe or unsubscribe a phone number from the monitoring database for your account.

Max records per file: 5,000,000.


The following table describes the fields to use for each record in your subscription file.

Column Header and NameDescriptionExample
INDICATORThe operation you want to perform. Enter ADD to subscribe a number or DEL to remove a number from subscription.ADD
MSISDNThe end user’s phone number to subscribe or unsubscribe, in international format including the country code.14089170001