PhoneID Monitoring - Subscription Files

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/

VariableDescription
your_suborg_idA number from TeleSign identifying your organization.

Example

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

File Naming Convention

MONITOR_{timestamp}.csv

VariableDescription
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.

Example

MONITOR_20190616T000723Z.csv

🚧

CAUTION:

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

Rows

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.

Columns

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

Did this page help you?