POST v1/Shops/{shopId}/MessageConversations/{messageConversationId}/Messages

Creates a new Message.

Request Information

URI Parameters

Name	Description	Type	Additional information
shopId	Id of shop	integer	Required.
messageConversationId	The id of the MessageConversation.	integer	Required.

Body Parameters

The new Message

MessageChanges

Name	Description	Type	Additional information
ExternalKey	Gets or sets the ExternalKey.	string	Max length: 255
ExternalTimestampUtc	Gets or sets the ExternalTimestampUtc.	date	None.
ReplyDateUtc	Gets or sets the ReplyDateUtc.	date	None.
ResponseTimeInSeconds	Gets or sets the ResponseTimeInSeconds.	integer	None.
MaximumResponseTimeInSeconds	Gets or sets the MaximumResponseTimeInSeconds.	integer	None.
Id	Gets or sets the identifier.	integer	Must be 0 (for insert operations)
MessageConversationId	Gets or sets the MessageConversationId.	integer	Required
Body	Gets or sets the Body.	string	Max length: 2147483647
CreationDate	Gets or sets the CreationDate.	date	None.
MessageSenderEnumValue	Gets or sets the MessageSenderTypeEnumValue.	MessageSenderTypeEnum	Required
IsRead	Gets or sets the IsRead.	boolean	Required
TypeEnumValue	Gets or sets the MessageSenderTypeEnumValue.	MessageTypeEnum	Required

Request Formats

application/json, text/json

Sample:

{
  "ExternalKey": "sample string 1",
  "ExternalTimestampUtc": "2026-01-11T16:13:13.2044103+01:00",
  "ReplyDateUtc": "2026-01-11T16:13:13.2044103+01:00",
  "ResponseTimeInSeconds": 1,
  "MaximumResponseTimeInSeconds": 1,
  "Id": 2,
  "MessageConversationId": 3,
  "Body": "sample string 4",
  "CreationDate": "2026-01-11T16:13:13.2044103+01:00",
  "MessageSenderEnumValue": 0,
  "IsRead": true,
  "TypeEnumValue": 0
}

application/xml, text/xml

Sample:

<MessageChanges xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Id>2</Id>
  <MessageConversationId>3</MessageConversationId>
  <Body>sample string 4</Body>
  <CreationDate>2026-01-11T16:13:13.2044103+01:00</CreationDate>
  <MessageSenderEnumValue>Employee</MessageSenderEnumValue>
  <IsRead>true</IsRead>
  <TypeEnumValue>Text</TypeEnumValue>
  <ExternalKey>sample string 1</ExternalKey>
  <ExternalTimestampUtc>2026-01-11T16:13:13.2044103+01:00</ExternalTimestampUtc>
  <ReplyDateUtc>2026-01-11T16:13:13.2044103+01:00</ReplyDateUtc>
  <ResponseTimeInSeconds>1</ResponseTimeInSeconds>
  <MaximumResponseTimeInSeconds>1</MaximumResponseTimeInSeconds>
</MessageChanges>

Response Information

Resource Description

Newly created Message

Message

Name	Description	Type	Additional information
ExternalKey	Gets or sets the ExternalKey.	string	Max length: 255
ExternalTimestampUtc	Gets or sets the ExternalTimestampUtc.	date	None.
ReplyDateUtc	Gets or sets the ReplyDateUtc.	date	None.
ResponseTimeInSeconds	Gets or sets the ResponseTimeInSeconds.	integer	None.
MaximumResponseTimeInSeconds	Gets or sets the MaximumResponseTimeInSeconds.	integer	None.
Id	Gets or sets the identifier.	integer	Must be 0 (for insert operations)
MessageConversationId	Gets or sets the MessageConversationId.	integer	Required
Body	Gets or sets the Body.	string	Max length: 2147483647
CreationDate	Gets or sets the CreationDate.	date	None.
MessageSenderEnumValue	Gets or sets the MessageSenderTypeEnumValue.	MessageSenderTypeEnum	Required
IsRead	Gets or sets the IsRead.	boolean	Required
TypeEnumValue	Gets or sets the MessageSenderTypeEnumValue.	MessageTypeEnum	Required

Response Formats

application/json, text/json

Sample:

{
  "ExternalKey": "sample string 1",
  "ExternalTimestampUtc": "2026-01-11T16:13:13.2044103+01:00",
  "ReplyDateUtc": "2026-01-11T16:13:13.2044103+01:00",
  "ResponseTimeInSeconds": 1,
  "MaximumResponseTimeInSeconds": 1,
  "Id": 2,
  "MessageConversationId": 3,
  "Body": "sample string 4",
  "CreationDate": "2026-01-11T16:13:13.2044103+01:00",
  "MessageSenderEnumValue": 0,
  "IsRead": true,
  "TypeEnumValue": 0
}

application/xml, text/xml

Sample:

<Message xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Id>2</Id>
  <MessageConversationId>3</MessageConversationId>
  <Body>sample string 4</Body>
  <CreationDate>2026-01-11T16:13:13.2044103+01:00</CreationDate>
  <MessageSenderEnumValue>Employee</MessageSenderEnumValue>
  <IsRead>true</IsRead>
  <TypeEnumValue>Text</TypeEnumValue>
  <ExternalKey>sample string 1</ExternalKey>
  <ExternalTimestampUtc>2026-01-11T16:13:13.2044103+01:00</ExternalTimestampUtc>
  <ReplyDateUtc>2026-01-11T16:13:13.2044103+01:00</ReplyDateUtc>
  <ResponseTimeInSeconds>1</ResponseTimeInSeconds>
  <MaximumResponseTimeInSeconds>1</MaximumResponseTimeInSeconds>
</Message>