Placewise API
Get startedExplore
Get startedExplore
Performance Cloud 🗗
Placewise 🗗
ExplorePublic APIManagement APIUsers API
Operations APIMessaging APIReporting APIML APIData API
ExplorePublic APIManagement APIUsers API
Operations APIMessaging APIReporting APIML APIData API
  1. Conversations
  • Introduction
  • Users
    • Introduction
    • Account
      • Show Notifications Settings
      • Update Notifications Settings
    • List Users
      GET
  • Conversations
    • Introduction
    • Conversations
      • Mark Conversation as "received"
        PUT
      • Create Conversation
        POST
      • List Conversations
        GET
      • Show Conversation
        GET
      • Mark Conversation as "seen"
        PUT
      • Archive Conversation
        PUT
    • Messages
      • Create Message
      • List Messages
      • Archive Message
  • Notifications
    • List Notifications
      GET
    • Show Notification
      GET
    • Mark all Notifications as Received
      PUT
    • Mark Notification as Seen
      PUT
    • Mark all Notifications as Seen
      PUT
    • Mark Notification as Received
      PUT
  • Subunits Scopes
    • List Subunits Scopes for User
      GET
  1. Conversations

Create Conversation

Pending
POST
https://api.mpc.dev.placewise.com/v1/users/me/conversations
API Permit:Conversations:Api:Users:Conversations:Create
API Context:Customer
Authorizations:User
Creates Conversation along with the first Conversation.

Body Parameters#

KeyDescription
conversationConversation object - except for read-only attributes
messageMessage object - except for read-only attributes

Example#

When successful, returns created Conversation and Conversation
{
  "conversation": {}, // Conversation - see 'Conversation model'
  "message": {}, // Message - see 'Message model'
}

Request

Header Params

Body Params application/json

Example
{
    "conversation": {
        "user_ids": ["85cd878e-a6af-4013-ab24-770d9ecd7819"]
    },
    "message": {
        "content": "HI there!!!"
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C#
Ruby
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.mpc.dev.placewise.com/v1/users/me/conversations' \
--header 'X-User-Agent;' \
--header 'X-Product-Name;' \
--header 'X-Loyalty-Club-Slug;' \
--header 'X-Customer;' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "conversation": {
        "user_ids": ["85cd878e-a6af-4013-ab24-770d9ecd7819"]
    },
    "message": {
        "content": "HI there!!!"
    }
}'

Responses

🟢200Success
application/json
Body

Example
{}
Previous
Mark Conversation as "received"
Next
List Conversations
Built with