FlexV1Assessments3

FlexV1Channel4

FlexV1Configuration2

FlexV1ConfiguredPlugin2

FlexV1FlexFlow5

FlexV1InsightsAssessmentsComment2

FlexV1InsightsConversations1

FlexV1InsightsQuestionnaires5

FlexV1InsightsQuestionnairesCategory4

FlexV1InsightsQuestionnairesQuestion4

FlexV1InsightsSegments1

FlexV1InsightsSession1

FlexV1InsightsSettingsAnswerSets1

FlexV1InsightsSettingsComment1

FlexV1InsightsUserRoles1

FlexV1Interaction3

FlexV1InteractionChannel3

FlexV1InteractionChannelInvite2

FlexV1InteractionChannelParticipant3

FlexV1InteractionTransfer3

FlexV1Plugin4

FlexV1PluginArchive1

FlexV1PluginConfiguration3

FlexV1PluginConfigurationArchive1

FlexV1PluginRelease3

FlexV1PluginVersionArchive1

FlexV1PluginVersions3

FlexV1ProvisioningStatus1

FlexV1WebChannel5

FlexV1Interaction

Create a new Interaction.

post/v1/Interactions

Response

sidstring nullable

The unique string created by Twilio to identify an Interaction resource, prefixed with KD.

{"stackTrail":"components:schemas:flex.v1.interaction:properties:channel","oasType":"schema","type":"unknown","description":"A JSON object that defines the Interaction’s communication channel and includes details about the channel. See the [Outbound SMS](https://www.twilio.com/docs/flex/developer/conversations/interactions-api/interactions#agent-initiated-outbound-interactions) and [inbound (API-initiated)](https://www.twilio.com/docs/flex/developer/conversations/interactions-api/interactions#api-initiated-contact) Channel object examples.","nullable":true}

{"stackTrail":"components:schemas:flex.v1.interaction:properties:routing","oasType":"schema","type":"unknown","description":"A JSON Object representing the routing rules for the Interaction Channel. See [Outbound SMS Example](https://www.twilio.com/docs/flex/developer/conversations/interactions-api/interactions#agent-initiated-outbound-interactions) for an example Routing object. The Interactions resource uses TaskRouter for all routing functionality. \n All attributes in the Routing object on your Interaction request body are added “as is” to the task. For a list of known attributes consumed by the Flex UI and/or Flex Insights, see [Known Task Attributes](https://www.twilio.com/docs/flex/developer/conversations/interactions-api#task-attributes).","nullable":true}

urlstring uri nullable

linksobject nullable

interaction_context_sidstring nullable

webhook_ttidstring nullable

Changes

Changed in 7 of the 51 revisions of this API.79

Sep 4, 2025v105805a8f9c8511See the full diff
- ▲
  removed the success response with the status
  response-success-status-removed
- ○
  added the success response with the status
  response-success-status-added
Jul 3, 2025v10e4cd336d78a22See the full diff
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ○
  the request property type was generalized from object to no type
  request-property-type-generalized
- ○
  the request property type was generalized from object to no type
  request-property-type-generalized
May 5, 2025v12f0de8ff61252See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the optional property to the response with the status
  response-optional-property-added
Mar 11, 2025v165f781b3f6b14See the full diff
- ▲
  the request property type changed from no type to object
  request-property-type-changed
- ▲
  the request property type changed from no type to object
  request-property-type-changed
- ▲
  the response's property type changed from no type to object for status
  response-property-type-changed
- ▲
  the response's property type changed from no type to object for status
  response-property-type-changed
May 24, 2024v17e7d5d33e5821See the full diff
- ○
  the request property became optional
  request-property-became-optional
Aug 10, 2023v1c37c20a0a1cb1See the full diff
- ○
  api tag FlexV1Interaction added
  api-tag-added
Jul 13, 2023v10a02afc7903e2See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the optional property to the response with the status
  response-optional-property-added

Full history