Create a List-Based Email Send Definition

This page contains information on creating an email send definition. You can use the email send definition to send an email to a list of subscribers.

Why Create an Email Send Definition

By creating an email send definition using the SOAP API, you can send an email to a list of subscribers from your development environment or other system. You can specify all the parameters necessary for an email send and have them stored so that the send can be initiated multiple times without having to setup the parameters again. You must setup an email send definition to send to a data extension through the API.

How to Create an Email Send Definition

Use the sample code below as a model to create your own code.

You can have your account updated to use the following information to retrieve default sender profiles, default delivery profiles, and default transactional and commercial send classifications.

This functionality is available only for accounts created after October 7, 2011, and it must be enabled for your accout before you can use it. Please contact your Marketing Cloud representative for more information.

  • New customer key for default sender profile = DEFAULT
  • New customer key for default delivery profile = DEFAULT
  • New customer key for default transactional send classification = Default Transactional
  • New customer key for default commercial send classification = Default Commercial

Sample .NET Code

Create the Email Send Definition

Retrieve Send Classification

Retrieve Email Send Definition

Sample PHP Code

Create Email Send Definition

Perform Email Send Definition