Sending vCard messages using HTTP

Overview

This page describes how to send a vCard message through the SMS Gateway. For information about integrating with the SMS Gateway, see either Sending a Single SMS or Broadcasting an SMS.

Sending a vCard

Single-recipient end points:	http://sms.openmarket.com/sms/v1/send https://sms.openmarket.com/sms/v1/send
Broadcast end points: (HTTP POST only)	http://sms.openmarket.com/sms/v1/bulksend https://sms.openmarket.com/sms/v1/bulksend

Example single-recipient request:

http://sms.openmarket.com/sms/v1/send?user=MyMXOneAccount&pass=MyP4S5w0rD&smsto=12515550100&vcard_data=BEGIN%3AVCARD%0D%0AVERSION%3A2.1%0D%0AFN%3AJohn+Smith%0D%0ATEL%3BWORK%3BVOICE%3A442071231234%0D%0ATEL%3BMOBILE%3BVOICE%3A447700900999%0D%0ATEL%3BHOME%3BFAX%3A442071231235%0D%0AEND%3AVCARD

This send a vCard for John Smith to the number 12515550100. Each line in the vCard must have a carriage return and line feed character (different cell phones require either one of these characters). The URL encoding for these is %0D%0A.

The example vCard, before being URL encoded, has the following format and content:

BEGIN:VCARD
VERSION:2.1
FN:John Smith
TEL;WORK;VOICE:442071231234
TEL;MOBILE;VOICE:447700900999
TEL;HOME;FAX:442071231235
END:VCARD

Mandatory parameters:

Parameter	Description
user	The SMS Gateway account you are sending the message through.
pass	The password for the SMS Gateway account.
smsto	The MSISDN of the message recipient in international format (e.g. 12515550100). No leading "+" is required. If you are sending a broadcast SMS request, separate each MSISDN with a line break (e.g. smsto=12515550100%0A12515550123%0A12515550145).
vcard_data	The vCard you are sending.

Optional parameters specific to this request type:

There are no optional parameters specific to sending a vCard message request.

Optional parameters you can use for any request type:

smsfrom: sets the originator for the message—this parameter is mandatory for standard rate messages in all regions bar the US
submitid: used to send broadcast SMS messages
report: sets the delivery reports you want for the message
response: (for single-recipient requests only) changes the format of the HTTP response from the SMS Gateway
note, subaccount: optional reporting notes that you can add to the request
vp, billingsingleshot: alters the validity period and billing for the SMS message
purpose: (US only) adds message purpose details required by Verizon for Premium Rate services
optin1, optin1ts, optin2, optin2ts: (US only) adds opt-in details required by T-Mobile US for Premium Rate services