Send TriggeredSend Email

Use a triggered send to reach a subscriber after they perform a specific action.

Sample .NET Code

1public void testTriggeredSendEmail()
2{
3    TriggeredSendDefinition definition = new TriggeredSendDefinition();
4    definition.CustomerKey = "Definition_Key";
5
6    //subscriber to whom email is sent
7    Subscriber subscriber = new Subscriber();
8    subscriber.EmailAddress = "aruiz@example.com";
9    subscriber.SubscriberKey = "aruiz@example.com";
10    TriggeredSend send = new TriggeredSend();
11
12    send.TriggeredSendDefinition = definition;
13
14    //If passing Full HTML_Body, pass value to HTML__Body
15    ETServiceClient.ETClient.Attribute attribute1 = new ETServiceClient.ETClient.Attribute();
16    attribute1.Name = "HTML__BODY";
17    //attribute2.Value = html;
18    //set HTML content to Email, Testing foreign language.
19    attribute1.Value = "????????????????????";
20    subscriber.Attributes = new ETServiceClient.ETClient.Attribute[] { attribute1 }; //set attribute value and assign that to subscriber
21    send.Subscribers = new Subscriber[] { subscriber }; //set subscriber to Triggered send
22    APIObject[] sends = { send };
23    String requestId = null;
24    String overAllStatus = null;
25    CreateOptions test = new CreateOptions();
26    //If you want to send email Asynchronous, enable permission.
27    test.RequestType = RequestType.Asynchronous;
28      CreateResult[] results = soapClient.Create(new CreateOptions(), sends, out requestId, out overAllStatus);
29    Console.Write("Status ::: " + overAllStatus);
30}

Sample Java Code (Axis 1.4)

1public void testTriggeredSend () throws RemoteException {
2
3        Soap_PortType stub = init();
4        TriggeredSendDefinition sendDefinition = new TriggeredSendDefinition();
5        sendDefinition.setCustomerKey("Test_Dynamic_Href");         //this is that External_Key
6        TriggeredSend triggeredSend = new TriggeredSend();
7        Subscriber subscriber = new Subscriber();
8        subscriber.setEmailAddress("acruz@example.com");  //Subscriber to whom email is sent.
9        subscriber.setSubscriberKey("Dynamic_Herf");          //Unique identifier for this email_Id
10        Attribute attribute = new Attribute();
11        attribute.setName("LINK_HREF_1");                    //Attribute in body similar to "HTML__Body"
12        // attribute.setName("%%=TREATASCONTENT(HTML_HREF_1)=%%");
13        attribute.setValue("<a href='httpgetwrap|http://www.marketingcloud.com' alias='MC'>Dynamic Link</a>");
14        subscriber.setAttributes(new Attribute[]{attribute});
15       /* Owner owner = new Owner();
16        owner.setFromName("FromName");       //At run time you change from user and email address
17        owner.setFromAddress("example@example.com");
18        triggeredSend.setOwner(owner);*/
19        triggeredSend.setSubscribers(new Subscriber[]{subscriber});
20        triggeredSend.setTriggeredSendDefinition(sendDefinition);
21        CreateOptions createOptions = new CreateOptions();
22        //createOptions.setRequestType(RequestType.Synchronous);
23        CreateRequest createRequest = new CreateRequest(createOptions, new APIObject[]{triggeredSend});
24        CreateResponse createResponse = stub.create(createRequest);
25        System.out.println("TriggeredSend :::  " + createResponse.getOverallStatus());
26}

Sample SOAP Envelope

1<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance
2">
3 <Header>
4    <fueloauth>YOUR_ACCESS_TOKEN</fueloauth>
5 </Header>
6 <Body>
7   <CreateRequest xmlns="http://exacttarget.com/wsdl/partnerAPI">
8    <Objects xsi:type="TriggeredSend">
9      <PartnerKey xsi:nil="true"/>
10      <ObjectID xsi:nil="true"/>
11      <TriggeredSendDefinition>
12       <PartnerKey xsi:nil="true"/>
13       <ObjectID xsi:nil="true"/>
14       <CustomerKey>Definition_Key</CustomerKey>
15      </TriggeredSendDefinition>
16      <Subscribers>
17       <PartnerKey xsi:nil="true"/>
18       <ObjectID xsi:nil="true"/>
19       <EmailAddress>aruiz@example.com</EmailAddress>
20       <SubscriberKey>aruiz@example.com</SubscriberKey>
21       <Attributes>
22         <Name>HTML__BODY</Name>
23         <Value>????????????????????</Value>
24       </Attributes>
25      </Subscribers>
26    </Objects>
27   </CreateRequest>
28 </Body>
29</Envelope>