POST messages

POST /messages

Publishes content from a given persona on a given channel to given player(s).

You will need to use GET personas and GET teams to have the required data.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Email example

{
  "persona": "3-49786",
  "channel": "mail",
  "subject": "Great Win",
  "body": "Congrats on securing Conducttr as the season's sponsor!",
  "to": "[e-mail]",
  "cc": "[e-mail], [e-mail]",
  "bcc": "[e-mail]
  "sentiment": "positive",
  "team_id": "3437866",
  "type": "team",
  "ts": 1738686056
}

Website Article

{
  "persona": "3-49786",
  "channel": "websites",
  "title": "New World Order",
  "subtitle": "i'm a subtitle",
  "body": "message body to team",
  "to": "[e-mail]",
  "assets": [
    {
      "type": "image",
      "assetUrl": "https://conducttr-a.akamaihd.net/fa/2306/06/22474/2023-06-06-12-15-47.png",
      "alt": ""
    },
    {
      "type": "video",
      "assetUrl": "https://conducttr-a.akamaihd.net/v/2305/p/51001/syrian-refugee-crisis-pl.m3u8",
      "alt": ""
    }
  ],
  "sentiment": "positive",
  "team_id": 3437872,
  "type": "team",
  "isDraft": 0,
  "ts": 1738686056
}

Media Pop-up

{
  "persona": "3-49786",
  "channel": "notifications",
  "player_email": "[e-mail]",
  "subject": "hello world",
  "body": "message body to team",
  "assets": [
    {
      "type": "video",
      "assetUrl": "https://conducttr-a.akamaihd.net/v/2305/p/51001/syrian-refugee-crisis-pl.m3u8",
      "alt": ""
    }
  ],
  "sentiment": "positive",
  "team_id": 3437866,
  "type": "team",
  "ts": 1738686056
}

Social media

{
  "persona": "3-49786",
  "channel": "microblog",
  "subject": "hello world",
  "body": "message body to team",
  "assets": [],
  "replies": 1,
  "likes": 3,
  "reposts": 2,
  "sentiment": "positive",
  "team_id": 3437866,
  "type": "team",
  "ts": 1738686056
}

Hack

{
    "persona":"3-52963",
    "channel":"websites",
     "is_hacked": 1 | 0,
     "show_details": 1 | 0,
     "hacked_image" : "https://conducttrdev-a.akamaihd.net/fa/2602/13/22474/robdapanda-pov-from-boat-as-it-passes-under-tower-bridge-ar-f61a14af-ecfd-4ea1-a177-1378d44f4ab9-0.png",
    "team_id":"3441451",
    "type":"team",
    "ts": 1738686056
}

Name	Type	Description
persona	string	persona_id of the sending persona
player_email	email address	if present then message is sent to the player with that email address
channel	string	which channel the message should be published on
title	string	required for website article
subject	string	message subject (if it has one)
body	string	the message body
to	string	required if to a single person
assets	list of asset objects	see asset object below
sentiment	string	positive I negative I neutral this is for social media
type	string	individual I team
ts	unix timestamp	message timestamp
isDraft	boolean	1 or 0
replies	integer	number of comments or replies to post
likes	integer	number of likes
reposts	integer	number of reposts/shares
is_hacked	integer	1 = hack the website, 0 = restore the website
show_details	integer	1 = show website details, 0 = hide website details
hacked_image	url	url to the image to display instead of the website when hacked

Asset object

Name	Type	Description
type	string	image I video I audio I document
assetUrl	string	must be URL to the hosted asset
alt	string	description of asset

Response

200

{
  "message_id": "7b5a92a4-04a0-4b32-848c-1201df844cd1"
}

400

{
  "error": "Invalid request"
}