Alerts - Subscription files

📘
NOTE:
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

/home/ts_products/phone_id_monitor/customer_data/{your_suborg_id}/in/

Variable	Description
your_suborg_id	A number from Telesign identifying your organization.

Example

/home/ts_products/phoneid_monitor/customer_data/243203/in/

MONITOR_{timestamp}.csv

Variable	Description
timestamp	The 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.

Example

MONITOR_20190616T000723Z.csv

🚧
CAUTION:
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 Name	Description	Example
INDICATOR	The operation you want to perform. Enter ADD to subscribe a number or DEL to remove a number from subscription.	ADD
MSISDN	The end user’s phone number to subscribe or unsubscribe, in international format including the country code.	14089170001