YM REST Services

<back to all web services

SMSCampaigns

Requires Authentication
Requires any of the roles:admin, oauthadmin
The following routes are available for this service:
POST/Ams/{ClientID}/SMSCampaigns/{CampaignId}/SendTestSend the test SMS.
GET/Ams/{ClientID}/SMSCampaigns/{CampaignID}Return the details of a SMS Campaign.
PUT/Ams/{ClientID}/SMSCampaigns/{CampaignId}Update a given SMS Campaign.
DELETE/Ams/{ClientID}/SMSCampaigns/{CampaignId}Delete a given SMS Campaign.
SMSCampaigns Parameters:
NameParameterData TypeRequiredDescription
CampaignIDpathintNo
ListIDbodyintNo
CampaignNamebodystringNo
MessagebodystringNo
CampaignStatusbodyBulkEmailStatusNo
DateScheduledbodyDateTimeNo
TestCountryCodebodystringNo
TestMobileNumberbodystringNo
DateStartProcessingbodyDateTime?No
DateEndProcessingbodyDateTime?No
AdminNamebodystringNo
SenderNumberbodystringNo
DateJobSubmittedbodyDateTimeNo
ListNamebodystringNo
BaseDto Parameters:
NameParameterData TypeRequiredDescription
UsingRedisformboolNo
AppInitTimeformDateTimeNo
ServerIDformstringNo
BaseSharedDto Parameters:
NameParameterData TypeRequiredDescription
ClientIDformintNo
ResponseStatusformResponseStatusNo
BypassCacheformboolNo
DateCachedformDateTimeNo
DeviceformDeviceNo
SMSCampaignsResponse Parameters:
NameParameterData TypeRequiredDescription
SenderNumberformstringNo
SenderAliasformstringNo
NoOptOutformstringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /Ams/{ClientID}/SMSCampaigns/{CampaignId}/SendTest HTTP/1.1 
Host: ws.yourmembership.com 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	CampaignID: 0,
	ListID: 0,
	CampaignName: String,
	Message: String,
	CampaignStatus: InQueue,
	DateScheduled: 0001-01-01,
	TestCountryCode: String,
	TestMobileNumber: String,
	DateStartProcessing: 0001-01-01,
	DateEndProcessing: 0001-01-01,
	AdminName: String,
	SenderNumber: String,
	DateJobSubmitted: 0001-01-01,
	ListName: String,
	UsingRedis: True,
	AppInitTime: 2024-05-03T07:23:49.7169919-04:00,
	ServerID: WS-6-134-823,
	ClientID: 0,
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	},
	BypassCache: False,
	DateCached: 2024-05-03T08:14:15.7520811-04:00,
	Device: Desktop
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	SenderNumber: String,
	SenderAlias: String,
	NoOptOut: String,
	CampaignID: 0,
	ListID: 0,
	CampaignName: String,
	Message: String,
	CampaignStatus: InQueue,
	DateScheduled: 0001-01-01,
	TestCountryCode: String,
	TestMobileNumber: String,
	DateStartProcessing: 0001-01-01,
	DateEndProcessing: 0001-01-01,
	AdminName: String,
	DateJobSubmitted: 0001-01-01,
	ListName: String,
	UsingRedis: True,
	AppInitTime: 2024-05-03T07:23:49.7169919-04:00,
	ServerID: WS-6-134-823,
	ClientID: 0,
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	},
	BypassCache: False,
	DateCached: 2024-05-03T08:14:15.7628483-04:00,
	Device: Desktop
}