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 

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

SOAP Envelope 

1<soap:Body>
2    <CreateRequest xmlns="http://exacttarget.com/wsdl/partnerAPI">
3        <Options>
4            <RequestType>Asynchronous</RequestType>
5            <ConversationID>123456</ConversationID>
6        </Options>
7...