Placewise API
Get startedExplore
Get startedExplore
Performance Cloud 🗗
Placewise 🗗
ExplorePublic APIManagement APIUsers APIOperations APIMessaging API
Reporting APIML APIData API
ExplorePublic APIManagement APIUsers APIOperations APIMessaging API
Reporting APIML APIData API
  1. Messaging API
  • Introduction
  • Templating system
  • Message model
  • Sending model
  • Messages
    • Create Message
      POST
    • List Messages
      GET
    • Show Message
      GET
    • Update Message
      PUT
    • Duplicate Message
      PUT
    • Delete Message
      DELETE
  • Sendings
    • Show Sending
      GET
    • Create Sending
      POST
    • Update Sending
      PUT
    • Cancel Sending
      PUT
  • Templates (Standalone)
    • Introduction
    • Bee Templates
      • Introduction
      • List Bee Email Templates
      • Show Bee Email Template
      • List Bee Email Templates Tags
    • List Templates
      GET
    • Show Template
      GET
    • Create Template
      POST
    • Update Template
      PUT
    • Destroy Template
      DELETE
  • Misc
    • Show Messaging Settings
      GET
    • List Merge Properties
      GET
    • List Merge Properties Copy
      GET
  1. Messaging API

Message model

Model#

This schema describes Messages in the responses. Payload for creations and updates is significantly different and can be referenced in docs of their respective API endpoints.
Message

Multiple channels#

It is possible to provide multiple channels per Message. During sending execution, one of them will be chosen, based on:
channels which are available for recipient
order (priority) of channels in payload specified during Message creation
optional preference set on Sending

Channel attributes#

There are channel attributes specific for given type.
KeyChannel typeType
message.sender.typesmsenum: ['alphanumeric', 'international']
message.sender.valuesmsstring
message.from_emailemailstring
message.from_nameemailstring
When not provided explicitly, values of those the following attributes are taken from Loyalty Club configuration.
The sender describes how SMS sender will be displayed to the receiver of SMS.
Depending on selected sender.type, a sender.value can be provided according to the following table:
TypeValue
alphanumericString consisting of 2-11 characters
internationalAny MSISDN

Aggregated Sendings status#

If all Message's Sendings are draft or Message has no Sendings, then the sendings_status is draft.
If all Message's Sendings are transmitted, cancelled, failed or skipped, then the sendings_status is finished.
If none of the above conditions is true, then sendings_status is scheduled.
Previous
Templating system
Next
Sending model
Built with