Create Interaction Instance (Hub Data)

[This topic is pre-release documentation and is subject to change.]

Creates a new Interaction instance within the specified Hub. If the instance already exists, it is updated.


The request is constructed as follows:

HTTP Verb Request URI
POST <hub-endpoint>/data/Interactions?api-version=2017-04-26

URI Parameters

URI Parameter Required Description
Hub-endpoint Yes The base URL for your Customer Insights Hub.

Request Body

A JSON object describing a Interaction instance, for example:

    ... <etc.>


The response includes an HTTP status code, a response body and a set of response headers.

Response Body

The body contains the Interaction instance along with the assigned Interaction ID and timestamp (in UTC), for example:

     'InteractionId': '<SomeId>',
    ... <etc.>
     'TimeStamp': '<DateTime-Offset>'

Status Code

  • 202 (Accepted) - if the request was accepted and the instance creation is in process.