YM REST Services

CampaignEmailLists

**Requires Authentication**
Requires any of the roles:	admin, oauthadmin

The following routes are available for this service:
GET	/Ams/{ClientID}/CampaignEmailLists	Return the CampaignEmailLists data.
GET	/Ams/{ClientID}/CampaignEmailLists/{ListId}	Return the CampaignEmailList details and records.
PUT	/Ams/{ClientID}/CampaignEmailLists/{ListId}	Update the CampaignEmailList.
DELETE	/Ams/{ClientID}/CampaignEmailLists/{ListId}	Delete the CampaignEmailList for a given List ID.
DELETE	/Ams/{ClientID}/CampaignEmailLists/{ListId}/ListRecipientId/{ListRecipientId}	Delete a Recipient in the CampaignEmailList for a given List ID.

**CampaignEmailLists** Parameters:
Name	Parameter	Data Type	Required
ListType	body	EmailListType	No
ListId	path	int	No
ListRecipientId	path	long	No
CategoryId	body	int	No
StatusId	body	EmailStatus	No
ListName	body	string	No
PageSize	body	int	No
PageNumber	body	int	No
IsForceReload	body	bool	No
OrderBy	body	string	No
OrderByDirection	body	string	No
Origin	body	string	No
CountDuplicateEmails	body	bool	No

**BaseDto** Parameters:
Name	Parameter	Data Type	Required
UsingRedis	form	bool	No
AppInitTime	form	DateTime	No
ServerID	form	string	No

**BaseSharedDto** Parameters:
Name	Parameter	Data Type	Required
ClientID	form	int	No
ResponseStatus	form	ResponseStatus	No
BypassCache	form	bool	No
DateCached	form	DateTime	No
Device	form	Device	No

**CampaignEmailListsResponse** Parameters:
Name	Parameter	Data Type	Required
ListCount	form	int	No
CampaignEmailListDetail	form	CampaignEmailListDetail	No
CampaignEmailLists	form	List<CampaignEmailList>	No
ListReLoadStatus	form	CampaignListReloadStatus	No

**CampaignEmailListDetail** Parameters:
Name	Parameter	Data Type	Required
TotalCount	form	int	No
TotalToSend	form	int	No
Complaints	form	int	No
HardBounces	form	int	No
GlobalOptouts	form	int	No
CategoryOptouts	form	int	No
CampaignEmailListItems	form	List<CampaignEmailListItem>	No
DuplicateEmailCount	form	int	No

**CampaignEmailList** Parameters:
Name	Parameter	Data Type	Required
ListId	form	int	No
ListType	form	EmailListType	No
ListSize	form	int	No
ListName	form	string	No
ListArea	form	EmailListArea	No
DateCreated	form	DateTime	No
DateModified	form	DateTime	No
DateLastUpdated	form	DateTime	No
HumanQuery	form	string	No

**CampaignEmailListItem** Parameters:
Name	Parameter	Data Type	Required
Id	form	long	No
MemberId	form	int	No
FirstName	form	string	No
LastName	form	string	No
Email	form	string	No
CounrtyDialCode	form	string	No
AreaCode	form	string	No
Mobile	form	string	No
EmailStatus	form	EmailStatus	No

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.

PUT /Ams/{ClientID}/CampaignEmailLists HTTP/1.1 
Host: ws.yourmembership.com 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	ListType: None,
	ListId: 0,
	ListRecipientId: 0,
	CategoryId: 0,
	StatusId: None,
	ListName: String,
	PageSize: 0,
	PageNumber: 0,
	IsForceReload: False,
	OrderBy: String,
	OrderByDirection: String,
	Origin: String,
	CountDuplicateEmails: False,
	UsingRedis: True,
	AppInitTime: 2025-11-04T16:19:51.8012901-05:00,
	ServerID: WS-4-51-163,
	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: 2025-11-04T16:48:39.4657977-05:00,
	Device: Desktop
}

HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	ListCount: 0,
	CampaignEmailListDetail: 
	{
		TotalCount: 0,
		TotalToSend: 0,
		Complaints: 0,
		HardBounces: 0,
		GlobalOptouts: 0,
		CategoryOptouts: 0,
		CampaignEmailListItems: 
		[
			{
				Id: 0,
				MemberId: 0,
				FirstName: String,
				LastName: String,
				Email: String,
				CounrtyDialCode: String,
				AreaCode: String,
				Mobile: String,
				EmailStatus: None
			}
		],
		DuplicateEmailCount: 0,
		ListId: 0,
		ListType: None,
		ListSize: 0,
		ListName: String,
		ListArea: None,
		DateCreated: 0001-01-01,
		DateModified: 0001-01-01,
		DateLastUpdated: 0001-01-01,
		HumanQuery: String
	},
	CampaignEmailLists: 
	[
		{
			ListId: 0,
			ListType: None,
			ListSize: 0,
			ListName: String,
			ListArea: None,
			DateCreated: 0001-01-01,
			DateModified: 0001-01-01,
			DateLastUpdated: 0001-01-01,
			HumanQuery: String
		}
	],
	ListReLoadStatus: None,
	ListType: None,
	ListId: 0,
	ListRecipientId: 0,
	CategoryId: 0,
	StatusId: None,
	ListName: String,
	PageSize: 0,
	PageNumber: 0,
	IsForceReload: False,
	OrderBy: String,
	OrderByDirection: String,
	Origin: String,
	CountDuplicateEmails: False,
	UsingRedis: True,
	AppInitTime: 2025-11-04T16:19:51.8012901-05:00,
	ServerID: WS-4-51-163,
	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: 2025-11-04T16:48:39.4846451-05:00,
	Device: Desktop
}