Some applications accept customer data and associated email message content in the form of CSV files. The CSV adapter in Blueshift exports a message into a CSV file in your S3 bucket instead of actually sending it to the customer. Unlike cloud apps which send messages real time to a third party messaging service provider, the CSV app can be used for sending bulk messages, thereby avoiding rate limitations on the third party messaging provider's platform.

Supported message types

Blueshift's CSV adapter supports both SMS and MMS messages.


For MMS messages, you must check with your third party messaging provider to confirm which media types are supported and understand the file size limitations.

Exported data

Consider the following points for the CSV files created for messages generated by a trigger:

  • In a segment triggered campaign or an event triggered campaign:
    • A new message file is generated every 30 minutes after the campaign is launched, even if the number of messages sent is 0.
    • A file can contain a maximum of 10000 messages. If more than 10K messages are generated in the 30 minute period, multiple files are created.
    • The maximum file size is 4GB. If the file size exceeds 4GB, additional files are created.
  • For one-time and recurring campaigns, a single message file is generated after after the campaign completes executing.

Example 1: A campaign trigger sends 10,000 messages in 5 minutes. A file is generated for the 10,000 messages at the 5 minute mark.

Example 2: A campaign trigger sends 6,000 messages in 30 minutes. A file is generated for 6,000 messages at the 30 minute mark.


Before you can set up integration with Blueshift, you must have your Amazon S3 bucket details handy.


It is important that all your customer phone numbers are saved in the E.164 standard.

Set up integration

To export campaign SMS data and messages from Blueshift as a CSV, simply add the details for your Amazon S3 bucket to the adapter you create in Blueshift. 

To set up integration, complete the following steps:

  1. Sign in to the Blueshift app, and click App Hub in the left navigation menu.
  2. Go to All Apps, search for, and select SMS as CSV via S3.
  3. You can also go to SMS Apps and select SMS as CSV via S3.
  4. Click Configure to view all the configured adapters.
  5. Click +ADAPTER to add an adapter.
  6. Add a Name for the adapter.  If you have multiple adapters, the adapter name helps you to identify the integration.
  7. Provide the following details for integration:


    Field Description
    AWS Region Specify the AWS region where the S3 bucket resides.
    AWS Key The Access Key ID that we use to export the data to your S3 bucket.
    AWS Secret The Secret Access Key that we use to export the data to your S3 bucket.  
    AWS Bucket Provide the URL to your S3 bucket. 
    AWS Path Specify the path on the S3 bucket where you want us to store the files.
  8. Edit and add Field Mappings if required.
  9. Click Save to add the adapter

Next steps

  1. Create an SMS template for your messages.
  2. In your campaign journey, add an SMS trigger. On the SMS tab of the trigger, go to Send Settings and specify SMS as CSV via S3 as the App and select the adapter that you just created.
Was this article helpful?
0 out of 0 found this helpful



Please sign in to leave a comment.