Identify One Call Using CreateOptions and ConversationID

A request can have an external unique identifier, typically the ConversationID. If you don't specify a ConversationID, include the RequestID. Using this approach provides these added benefits:

• Results are available for calls using external identifiers
• Data is protected from replayed API calls

C# Example

CreateOptions co = new CreateOptions();
co.RequestType = RequestType.Asynchronous;
co.RequestTypeSpecified = true;
co.ConversationID = "123456"; // or any other unique string
CreateResult[] results = integrationFramework.Create(co, new APIObject[] { ts }, out requestID, out status);

SOAP Envelope

<soap:Body>
    <CreateRequest xmlns="http://exacttarget.com/wsdl/partnerAPI">
        <Options>
            <RequestType>Asynchronous</RequestType>
            <ConversationID>123456</ConversationID>
        </Options>
...