---
schema_version: "1"
id: 698d3c573bf9e24694cad823305d76cc16f3650d47a9811e17bdc0d96506f017
title: Scenarios
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/scenarios_appex.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/scenarios_appex.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: d7e65f43c5f32e169960d451545271fdc2c535d4f4f475d96899d8ae94bc8f73
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# Scenarios

## Sample Code for Marketing Cloud Engagement for AppExchange API Calls

This section provides sample code related to Marketing Cloud Engagement for AppExchange API.

### Sample Create Call

```
// Action: Create SalesforceSend object
CreateResult[] results = etForAppx.Create(new CreateOptions(), new APIObject[] { sfs }, out requestID, out status);
```

This code sample represents the create call, and it executes one Salesforce send. Note the following aspects about this call:

- Default CreationOptions properties are used.
- One or many SalesforceSend or Email objects can be created with a single Create call.
- One CreateResult object is associated with one APIObject - in this case, a SalesforceSend object.
- Returned "out" parameters are subject to your development environment. In .NET, they are exposed as parameters on the Create call.

### Sample Re-subscribe Call

```
private void Activate(){
    Console.WriteLine("updating sf subscriber");
    int subTypeID = -1;
    string status = null;
    string rid = null;
    PartnerAPI.Subscriber wsdlSub = new PartnerAPI.Subscriber();
    //set the 18 digit SF ID
    wsdlSub.SubscriberKey = "0037000000UyRdo";
    //set the status to active
    wsdlSub.Status = SubscriberStatus.Active;
    wsdlSub.StatusSpecified = true;
    //set the subscriber Type
    PartnerAPI.SubscriberTypeDefinition std = new PartnerAPI.SubscriberTypeDefinition();
    std.SubscriberType = "salesforcecontact"; //"salesforcelead"
    wsdlSub.SubscriberTypeDefinition = std;
    wsdlSub.IDSpecified = false;
    wsdlSub.Client = new ClientID();
    wsdlSub.Client.ID = 3069; //wsdlSub.Client.UserID = objPrincipal.EmployeeID; PartnerAPI.ServiceWse partnerAPI = new PartnerAPI.ServiceWse();
    UsernameTokenProvider utp = new UsernameTokenProvider("etsfdev2", "xxxx"); partnerAPI.SetClientCredential<UsernameToken>(utp.GetToken());
    Policy policy = new Policy(new UsernameOverTransportAssertion());
    partnerAPI.SetPolicy(policy);
    partnerAPI.Timeout = -1;
    UpdateResult[] results = partnerAPI.Update(new PartnerAPI.UpdateOptions(), new PartnerAPI.APIObject[] { wsdlSub }, out rid, out status);
    for (int cntr = 0; cntr < results.Length; cntr++)
    {
    Console.WriteLine(string.Format("Results for object {0}: Status code: {1}. Message: {2}.", cntr, results[cntr].StatusCode, results[cntr].StatusMessage));
    }
    Console.ReadLine();
}
```

### Sample SOAP API Call

```
//1. Create email
Email email = new Email();
email.ID = 3079342;
email.IDSpecified = true;
//2. Specify target recipients
Target report = new Target();
report.ObjectID = "00O60000001PWEa";
report.ObjectType = ObjectTypes.Report;
//3. Specify target recipients to exclude from the send
Target reportExclude = new Target();
reportExclude.ObjectID = "00O60000001PWEc";
reportExclude.ObjectType = ObjectTypes.Report;
// 4. Create Salesforce send object
SalesforceSend sfs = new SalesforceSend();
sfs.Email = email;
sfs.Targets = new Target[] { report };
sfs.Exclusions = new Target[] { reportExclude };
sfs.FromName = "Lead/Contact Owner Name"; // Use CRM Record owner from from address and name
sfs.SendDate = DateTime.UtcNow.Add(3); // Use UTC time for Scheduling sends
//5. Use Create call to initiate the send
CreateResult[] results = etForAppx.Create(new CreateOptions(), new APIObject[] { sfs }, out requestID, out status);
//6. Print out overall results
Console.WriteLine(string.Format("Overall result: {0}. RequestID: {1}. Result Message: {2}", status, requestID, results[0].StatusMessage));
```