How to Batch Import /Register Sender Address (Telephone Numbers)

Customers that already have their own Longcode Telephone numbers (TN) can migrate them to the Syniverse Communication Gateway to be used for sending messages. Customers must ensure that all the necessary approvals from the TN Sponsor including purchase receipts or Letter of Authorization for the numbers is available and a valid SPIDs (NNID) associated with these numbers is also available before attempting to migrate to the Syniverse Platform. The receipts can be in pdf format.

Syniverse Cloud messaging services  allows customers with US or Canadian SMS-enabled Telephone Numbers (TN) to use them as Sender IDs for their P2P messaging applications:

Customers with TNs (Owns a SPID -Service Provider ID) and a Carrier-approved or grandfathered P2P use case.

Batch Import Via API

  • Submit your SPID to Syniverse for registration. (Please note that this requires a syniverse Implementation Manager to work with you on gathering all necessary information required to complete registration)

  • Once SPID/NNID registration is completed, submit a Batch Import for Sender ID Via API

  • Create import job for SenderIds - Format : csv file
  • Upload the attachment for numbers ( csv template for numbers import will be provided to you by the Syniverse Implementation team) 

Create a Sender ID import attachment job

curl '' -H 'Authorization: Bearer TOKEN' -H 'Content-Type: application/json;charset=UTF-8' --data-binary '{"designation":"SENDERIDS_IMPORT", "name":"Longcode Import","type":"application/","filename":"LongcodeImportTemplate.csv"}'

           Response will return the attachmentId - { tI5FuL12SivTANIv1BOXeMN}

Create the Access Token for Uploading Attachment Data (Returns Access Token)

curl '' -H 'Authorization: Bearer TOKEN' -H 'Content-Type: application/json;charset=UTF-8'  --data-binary '{"resource":"ATTACHMENT","resource_id":"tI5FuL12SivTANIv1BOXMN"}' 


Upload Attachment Data (using the access token)

curl '<use the accesstoken returned from the above step>/content' -X POST --data-binary @"/cygdrive/c/numbers/LongcodeImportTemplate.csv"  -H "Content-Type: application/octet-stream"

Repeat Steps above to upload receipts for your numbers. 


Create Sender Id Import Job (TN file) using attachment ID & receipt ID

curl -v -X POST -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d '{"import_attachment_id":" tI5FuL12SivTANIv1BOXeMN ", "receipts_attachment_id":"JibQ84mqM5gDjjisbnvPB2","register_number":false}'

Optional –

Check import job - state can be CREATED, RUNNING, COMPLETED. When COMPLETED, imported_count is the count of numbers imported and created as #private SenderId, Please bear in mind that phone number should be unique, but also the name of number (SenderId name respectively)

curl -X GET -H "Authorization: Bearer TOKEN" -H "ContentType: application/json"

Batch Import via SCG UI

  • Submit your SPID to Syniverse for registration.
  • Log in to the SCG UI
  • Navigate to “Messaging Accounts” menu
  • Select “Sender Address” and click on “+Purchase or Migrate Sender Address” Button
  • In the Purchase or Migrate Sender Address window, make sure the right Country is selected and Longcode button is selected, then click on the link to migrate your number
  • Navigate to the “Download CSV template” link and download the csv template for Sender IDs
  • Fill in your TNs following the format outlined
  • Upload the file using the “Select File” button.
  • Once completed, click the upload button
  • Now navigate to the upload receipt field and click the “Select File” button to upload your receipt or LOA. Note that you can also email your LOA to your Sales rep if applicable.
  • Complete the rest of the Sender ID form making sure not to check the “Register Number*. Submit the form and Sender IDs will be automatically generated for your TNs


Please note that the acquisition of a NNID from Netnumber and registration of TNs with Netnumber is the responsibility of the Customer. We require that these criteria is in place prior and Implementation of your service has been completed prior to importing your numbers for Sender IDs



Was this article helpful?
0 out of 0 found this helpful


Article is closed for comments.