[SalesForce] Triggered Send using REST API with Data Extension

I would like to substitute some variables in my email template using SFMC's REST API.

For example, in my email:

%%[Substitute_var1]%%

When I call it through REST, how it's possible to substitute this variable?

Best Answer

The REST call to send a triggered message does not provide the ability to update a data extension. It does allow you to update "send time attributes' for a subscriber, and those are passed in as the to: section of the payload:

  "To":{
     "Address":"example1@example.com",
     "SubscriberKey":"example1@example.com",
     "ContactAttributes":{
        "SubscriberAttributes":{
           "Region":"West", //passed in at send time
           "City":"Indianapolis", //passed in at send time
           "Substitute_var1":"Value" //passed in at send time
        }
     }
  }

These attributes for the subscriber will need to be created prior to sending.

Related Solutions

[SalesForce] Attachment : Triggered Send using REST API

A profile attribute could be used to hold the value for the location of the unique location for that subscribers PDF. This profile attribute would need to be created in the UI in the Profile Management section. Lets assume the field is called PDFLocation. The body of the email would have to contain a reference to the AttachFile function referencing that attribute:

%%=Attachfile("HTTP", PDFLocation)=%%

Then in the JSON body for ContactAttributes, pass the value:

{
    "From": {
        "Address": "code@exacttarget.com",
        "Name": "Code@"
    },
    "To": {
        "Address": "example@example.com",
        "SubscriberKey": "example@example.com",
        "ContactAttributes": {
            "SubscriberAttributes": {
                "PDFLocation": "http://www.exampledomain.com/somefile.pdf"
            }
        }
    }
}

[SalesForce] Creating triggered send without a data extension

You can achieve this when creating a triggered send definition under Email Studio -> Interactions -> Triggered Emails. There you need to select the All Subscribers list under "Subscriber Management".

Then you can trigger the send using the API and the key of the created triggered send:

/messaging/v1/messageDefinitionSends/key:[external key of your triggered send]/send

You need to supply the data you like to process in the body of the request sent to the api under To.ContactAttributes.SubscriberAttributes:

{
    "From": {
        "Address": "from@yourdomain.com",
        "Name": "yourname"
    },
    "To": {
        "Address": "subscriber@domain.com",
        "SubscriberKey": "SUBSCRIBERKEY",
        "ContactAttributes": {
            "SubscriberAttributes": {
                "YourAttribute": "DATA"
            }
        }
    }
}

Then you can use the data in the triggered email using the following AMPscript-code:

Var @YourAttribute
Set @YourAttribute = AttributeValue("YourAttribute")

Best Answer

Related Solutions

[SalesForce] Attachment : Triggered Send using REST API

[SalesForce] Creating triggered send without a data extension

Related Topic