One email to one receiver from Marketing Cloud Rest API

Question

I'm using Marketing Cloud Rest API and I have already created emails. How can I send one email to just one receiver via the API? Is it possible? I read the documentation about messageDefinitionSends and can't find a method for this action.

Answer 1

The documentation article you posted is the correct one for the desired task. You need to create a triggered send definition before you can use this call however. This can be done using Email Studio for example.

1. Creating a triggered email in Email Studio roughly works like this:

1. Go to Email Studio -> Interactions -> Messages -> Email -> Triggered Sends -> Create
2. Create Triggered Send
3. Complete Properties-form (here you select your external key you need for the request)
4. Select the created email to send
5. Complete Subscribers management-form
6. Set send options
7. Save

Additional and detailed information on the various options can be found in the Create a Triggered Email Message Interaction documentation article.

2. Send a POST-request to the API

Use [restendpoint]/messaging/v1/messageDefinitionSends/key:[external key of your triggered send]/send using your instance's endpoint and the external key of your triggered send definition defined earlier.

The body of your request could look like this:

{
    "From": {
        "Address": "[email protected]",
        "Name": "Your Company"
    },
    "To": {
        "Address": "[email protected]",
        "SubscriberKey": "SUBSCRIBERS_KEY"
    },
    "OPTIONS": {
      "RequestType": "SYNC"
    }
}