Use the code samples available with Microsoft Dynamics Marketing SDK package to get a demonstration of how to work with Microsoft Dynamics Marketing entities. More information: Sample code
Note
The code samples use shared helper code to perform common tasks, for example SAS and ACS authentication with the Service Bus queues. The helper code, which you might find useful in your applications, is available in the following folder in the SDK package: Samples\CS\Client.
For more information about running the samples, see the Readme file that is available with each sample code.
In the Samples/CS folder of the SDK download you will find a folder for each sample and an associated Readme file. The Readme file contains information about how to build and run the sample.
After running the program, select the options from the menu. Depending on the sample code you choose to run, the menu options will differ.
Sample code
|
Options
|
Demonstrates
|
Sample: Create and update external entities
|
Create or update external entity
|
CreateOrUpdateExternalEntityRequest class and CreateOrUpdateExternalEntityResponse class.
|
|
Retrieve entity
|
RetrieveExternalEntityRequest class and RetrieveExternalEntityResponse class.
|
|
Retrieve entity types
|
RetrieveExternalEntityTypesRequest class and RetrieveExternalEntityTypesResponse class.
|
|
Retrieve entity IDs
|
RetrieveExternalIdsRequest class and RetrieveExternalIdsResponse class.
|
|
Delete single entity
|
DeleteExternalEntityRequest class and DeleteExternalEntityResponse class.
|
|
Delete category
|
DeleteExternalEntityTypeRequest class and DeleteExternalEntityTypeResponse class.
|
Sample: Create, read, and update a category
|
Create/Update user-defined categories
|
CreateOrUpdateCustomFieldCategoriesRequest class and CreateOrUpdateCustomFieldCategoriesResponse class.
|
Sample: Create, read, update, and delete a company (including UDF custom fields)
|
Retrieve a company
|
RetrieveCompanyRequest class and RetrieveCompanyResponse class.
|
|
Create a company
|
CreateOrUpdateCompanyRequest class and CreateOrUpdateCompanyResponse class.
|
|
Update a company
|
CreateOrUpdateCompanyRequest class and CreateOrUpdateCompanyResponse class.
|
|
Delete a company
|
DeleteCompanyRequest class and DeleteCompanyResponse class.
|
|
Retrieve multiple companies
|
RetrieveCompaniesRequest class and RetrieveCompaniesResponseclass.
|
Sample: Create, read, update, and delete contact (including custom fields)
|
Retrieve a contact
|
RetrieveContactRequest class and RetrieveContactResponse class.
|
|
Create a contact
|
CreateOrUpdateContactRequest class and CreateOrUpdateContactResponse class.
|
|
Update a contact
|
CreateOrUpdateContactRequest class and CreateOrUpdateContactResponse class.
|
|
Delete a contact
|
DeleteContactRequest class and DeleteContactResponse class.
|
|
Retrieve a list of salutations
|
RetrieveSalutationsRequest class and RetrieveSalutationsResponse class.
|
|
Retrieve a list of currencies
|
RetrieveCurrenciesRequest class RetrieveCurrenciesResponse class.
|
|
Retrieve a list of languages
|
RetrieveLanguagesRequest class and RetrieveLanguagesResponse class.
|
|
Retrieve multiple contacts
|
RetrieveContactsRequest class and RetrieveContactsResponse class.
|
|
Create multiple contacts
|
CreateOrUpdateContactsRequest class and CreateOrUpdateContactsResponse class.
|
Sample: Create, read, update, and cancel event attendance
|
Retrieve an event attendance
|
RetrieveEventAttendanceRequest class and RetrieveEventAttendanceResponse class.
|
|
Create an event attendance
|
CreateOrUpdateEventAttendanceRequest class and CreateOrUpdateEventAttendanceResponse class.
|
|
Update an event attendance
|
CreateOrUpdateEventAttendanceRequest class and CreateOrUpdateEventAttendanceResponse class.
|
|
Cancel an event attendance
|
CancelEventAttendanceRequest class and CancelEventAttendanceResponse class.
|
|
Retrieve a list of event attendance statuses
|
RetrieveEventAttendanceStatusesRequest class and RetrieveEventAttendanceStatusesResponse class.
|
Sample: Create, read, update, and cancel event registration
|
Retrieve an event registration
|
RetrieveEventRegistrationRequest class and RetrieveEventRegistrationResponse class.
|
|
Create an event registration
|
CreateOrUpdateEventRegistrationRequest class and CreateOrUpdateEventRegistrationResponse class.
|
|
Update an event registration
|
CreateOrUpdateEventRegistrationRequest class and CreateOrUpdateEventRegistrationResponse class.
|
|
Cancel an event registration
|
CancelEventRegistrationRequest class and CancelEventRegistrationResponse class.
|
Sample: Create, read, update, and delete lead (including UDF custom fields)
|
Retrieve a lead
|
RetrieveLeadRequest class and RetrieveLeadResponse class.
|
|
Create a lead
|
CreateOrUpdateLeadRequest class and CreateOrUpdateLeadResponse class.
|
|
Update a lead
|
CreateOrUpdateLeadRequest class and CreateOrUpdateLeadResponse class.
|
|
Delete a lead
|
DeleteLeadRequest class and DeleteLeadResponse class.
|
|
Retrieve a list of priorities
|
RetrieveLeadPrioritiesRequest class and RetrieveLeadPrioritiesResponse class.
|
|
Retrieve a list of statuses
|
RetrieveLeadStatusesRequest class and RetrieveLeadStatusesResponse class.
|
|
Retrieve a list of territories
|
RetrieveTerritoriesRequest class and RetrieveTerritoriesResponse class.
|
|
Retrieve a list of sales ratings
|
RetrieveSalesRatingsRequest class and RetrieveSalesRatingsResponse class.
|
|
Retrieve multiple leads
|
RetrieveLeadsRequest class and RetrieveLeadsResponse class.
|
Sample: Create, read, update, and delete marketing results
|
Retrieve a marketing result
|
RetrieveMarketingResultRequest class and RetrieveMarketingResultResponse class.
|
|
Create a marketing result
|
CreateOrUpdateMarketingResultRequest class and CreateOrUpdateMarketingResultResponse class.
|
|
Update a marketing result
|
CreateOrUpdateMarketingResultRequest class and CreateOrUpdateMarketingResultResponse class.
|
|
Delete a marketing result
|
DeleteMarketingResultRequest class and DeleteMarketingResultResponse class.
|
|
Retrieve a list of marketing result types
|
RetrieveMarketingResultTypesRequest class and RetrieveMarketingResultTypesResponse class.
|
|
Retrieve multiple marketing results
|
RetrieveMarketingResultsRequest class and RetrieveMarketingResultsResponse class.
|
Sample: Retrieve custom fields by Belongs-To company and entity
|
Retrieve custom fields
|
RetrieveCustomFieldsRequest class and RetrieveCustomFieldsResponse class.
|
Sample: Manage lists and send transactional or commercial email
|
Retrieve transaction email messages
|
RetrieveEmailMessagesRequest class and RetrieveEmailMessagesResponse class.
|
Retrieve commercial email messages
|
RetrieveCommercialEmailMessagesRequest class and RetrieveCommercialEmailMessagesResponse class.
|
Retrieve message schema for email message
|
RetrieveMessageSchemaForEmailMessageRequest class and RetrieveMessageSchemaForEmailMessageResponse class.
|
Send email message by email
|
SendEmailMessageByEmailRequest class and SendEmailMessageByEmailResponse class.
|
Send email message by ID
|
SendEmailMessageByIdRequest class and SendEmailMessageByIdResponse class.
|
Send commercial email message
|
SendCommercialEmailMessageByIdRequest class and SendCommercialEmailMessageByIdResponse class.
|
Retrieve email message sent status
|
RetrieveEmailMessageSentStatusRequest class and RetrieveEmailMessageSentStatusResponse class.
|
Set contact permissions for an email address
|
SetContactPermissionsRequest class and SetContactPermissionsResponse class.
|
Set contact permissions for multiple email addresses
|
SetContactsPermissionsRequest class and SetContactsPermissionsResponse class.
|
Retrieve contact permissions for an email address
|
RetrieveContactPermissionsRequest class and RetrieveContactPermissionsResponse class.
|
Retrieve a list of email addresses for which contact permissions are missing
|
RetrieveEmailMessagesRequest class and RetrieveEmailMessagesResponse class.
|
Set email hard bounces to processed for a contact
|
SetEmailHardBouncesToProcessedForContactRequest class and SetEmailHardBouncesToProcessedForContactResponse class.
|
Retrieve unprocessed email hard bounces
|
RetrieveUnprocessedEmailHardBouncesRequest class and RetrieveUnprocessedEmailHardBouncesResponse class.
|
Sample: Work with marketing lists
|
Add contact to marketing list by email
|
AddContactToMarketingListByEmailRequest class and AddContactsToMarketingListByEmailsResponse class.
|
Add contacts to marketing lists by emails
|
AddContactsToMarketingListByEmailsRequest class and AddContactsToMarketingListByEmailsResponse class.
|
Add contact to marketing list by ID
|
AddContactToMarketingListByIdRequest class and AddContactToMarketingListByIdResponse class.
|
Add contacts to marketing list by IDs
|
AddContactsToMarketingListByIdsRequest class and AddContactsToMarketingListByIdsResponse class.
|
Copy contacts from marketing list
|
CopyContactsFromMarketingListRequest class and CopyContactsFromMarketingListResponse class.
|
Copy query to marketing list
|
CopyQueryToMarketingListRequest class and CopyQueryToMarketingListResponse class.
|
Create marketing list
|
CreateMarketingListRequest class and CreateMarketingListResponse class.
|
Delete marketing list
|
DeleteMarketingListRequest class and DeleteMarketingListResponse class.
|
Remove all contacts from marketing list
|
RemoveAllContactsFromMarketingListRequest class and RemoveAllContactsFromMarketingListResponse class.
|
Remove all contacts from marketing list by email
|
RemoveContactFromMarketingListByEmailRequest class and RemoveContactFromMarketingListByEmailResponse class.
|
Remove contact from marketing list by ID
|
RemoveContactFromMarketingListByIdRequest class and RemoveContactFromMarketingListByIdResponse class.
|
Retrieve all lists
|
RetrieveAllListsRequest class and RetrieveAllListsResponse class.
|
Retrieve marketing list
|
RetrieveMarketingListRequest class and RetrieveMarketingListResponse class.
|
Retrieve marketing lists
|
RetrieveMarketingListsRequest class and RetrieveMarketingListsResponse class.
|
Update marketing list
|
UpdateMarketingListRequest class and UpdateMarketingListResponse class.
|
Sample: Retrieve landing page submissions
|
Retrieve a landing page submission
|
RetrieveSubmissionRequest class and RetrieveSubmissionResponse class.
|