Create Conversation Message

Create a new message for a given conversation.

HTTP Request

POST https://dev.calry.app/api/v1/vrs/conversations

Headers

Header	Value
Authorization	Bearer YOUR_ACCESS_TOKEN
workspaceId	YOUR_WORKSPACE_ID
integrationAccountId	YOUR_INTEGRATION_ACCOUNT_ID

Example Request

curl --location 'https://dev.calry.app/api/v1/vrs/conversations' \
--header 'Authorization: Bearer eyJraWQiOiJzLThkOTQwNzI5LWYxZmItNDFhMS1hMjIzLTg5ZWY3NmZjZDIyOCIsInR5cCI6IkpXVCIsImFsZyI6IlJTMjU2In0.eyJpc3MiOiJodHRwOi8vbG9jYWxob3N0OjMwMDAvYXV0aCIsInVzZXJJZCI6IjY5YTYwNzVlLTViYTktNDA0NS05ZDZmLWY5YTJhZjAxOWVmNyIsIndvcmtzcGFjZUlkIjoiNGNjNTA5YjAtZDhmOC00YTU3LTlkNDgtNDQ0MThmYTUxNjBmIiwibmFtZSI6InRlc3QtdG9rZW4iLCJzb3VyY2UiOiJtaWNyb3NlcnZpY2UiLCJpYXQiOjE3MDIzMTQyMjAsImV4cCI6MTczODMxNDIyMH0.f0zNaSpDqFn4A8f2vUDdra11GxTv_9PhR7rdJprP5tVGw-qpp3m4LHCTtNFUSRg6gsrXm7XOHrNGZVOTOLmWl2f6S6TdMsACWvEV3lZp48bBGlluTWbPq2469sWAljF9bOlxpqDgbigHHb4bGNPqPOKh_xaSl-jJcBUMJqMnP7xdpEGjOW5dVDf7SxTlASA-GYoCiJy4AQ5F_7YtsL62Akl7l-BIjyrQZ6TtLBjUKkOiUpfVRDjgSaGWekiTL9t6cm0sZDhhoLXt3RM_lagjid9fEQLDk77zS6_ToJpaxqSQsNlZTd0lugM-wSQIrzwaaIR2KA_QyT5WiZPIO_VnQQ' \
--header 'workspaceId: 4cc509b0-d8f8-4a57-9d48-44418fa5160f' \
--header 'integrationAccountId: 52700950-7055-44bd-bd4c-c577798f3123' \
--header 'Content-Type: application/json' \
--data '{
    "conversationId": 2323711,
    "reservationId": 8163036,
    "body": "Hello there",
    "subject": "Reply to your booking",
    "type": "DIRECT"
}'

Request Body

The request body should be a JSON object containing the following fields:

Field	Type	Description
conversationId	string	Required. Unique identifier used to identify the conversation.
reservationId	number	Required. Unique identifier used to identify the reservation.
body	string	Required. Body of the conversation.

Note -

1. If in the conversation response the message type is EMAIL, then the subject and body are required.
2. If the message type is Airbnb, Vrbo, or Booking.com, then the type is DIRECT, and only the body is required.
3. If the message type is SMS, then the body is required.
4. If the message type is WhatsApp, then the body is required.

CalryConversationType

Value	Description
DIRECT	Direct conversation between the guest and the owner. (includes Airbnb, Vrbo, Booking.com etc)
EMAIL	Email conversation between the guest and the owner.
SMS	SMS conversation between the guest and the owner.
WHATSAPP	WhatsApp conversation between the guest and the owner.

Example Response

{
    "success": true,
    "data": {
        "conversationId": "500123081",
        "reservationId": "500128206",
        "messageId": "502204550",
        "message": "This is looking good"
    }
}