Create a Message

Request

POST https://api.comeet.co/conversations/{uid}/messages

Request body fields:

Name	Type	Optional	Description
time_sent	string	Required	YYYY-MM-DDTHH:mm:ssZ
subject	string	Optional
body	string	Required	HTML. The following tags are supported: `<b>` `<i>` `<u>` `<a>`
from	Contact	Required
to	Array of Contact	Required
cc	Array of Contact	Optional
bcc	Array of Contact	Optional

The Contact object:

Name	Type	Optional	Description
type	string	Required	One of the following: `user`, `candidate`, `source_contact`, `other`
first_name	string	Required
middle_name	string	Optional
last_name	string	Optional
email	string	Required if the `type` is not `candidate`
status	string	Required	Applies to `to`, `cc`, `bcc` (doesn't apply to `from`). One of the following: `Sent`, `Open`, `Failed`, `Clicked`

{
  "time_sent": "2018-01-01T12:50:50Z",
  "status": "Sent",
  "from": {
    "type": "user",
    "first_name": "Kelly",
    "middle_name": "",
    "last_name": "Lee",
    "email": "[email protected]"
  },
  "to": [
    {
      "type": "candidate",
      "first_name": "John",
      "middle_name": "",
      "last_name": "Johnson",
      "email": "[email protected]",
      "status": "Sent"
    }
  ],
  "cc": [],
  "bcc": [],
  "subject": "Director of Sales opportunity",
  "body": "Hi John, I wanted to see if you would be interested in interviewing for the Director of sales role in ACME."
}

Response

{
  "uid": "B12.121",
  "time_sent": "2018-01-01T12:50:50Z",
  "status": "Sent",
  "from": {
    "type": "user",
    "uid": "A00.001"
  },
  "to": [
    {
      "type": "candidate",
      "uid": "B99.999"
    }
    //...
  ],
  "cc": [],
  "bcc": [],
  "subject": "Director of Sales opportunity",
  "body": "Hi John, I wanted to see if you would be interested in interviewing for the Director of sales role in ACME."
}

{  
  "status":404,
  "error":"message_not_found",
  "message":"Message not found"
}