Create a new message

import requests
url = "https://example.ada.support/api/v2/conversations/conversation_id/messages/"
payload = {
    "author": {
        "role": "end_user",
        "id": "5df263b7db5a7e6ea03fae9b",
        "avatar": "https://www.gravatar.com",
        "display_name": "Ada Lovelace"
    },
    "content": {
        "type": "text",
        "body": "Hello, how can I help you?"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "id": "5df263b7db5a7e6ea03fae9b",
  "conversation_id": "5df263b7db5a7e6ea03fae9b",
  "author": {
    "role": "end_user",
    "id": "5df263b7db5a7e6ea03fae9b",
    "avatar": "https://www.gravatar.com",
    "display_name": "Ada Lovelace"
  },
  "content": {
    "type": "text",
    "body": "Hello, how can I help you?"
  },
  "created_at": "2020-09-20T00:00:00+00:00",
  "updated_at": "2020-09-20T00:00:00+00:00"
}

Create a new message in a conversation. The maximum request size is 10MB.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

conversation_idstringRequiredformat: "id"

The ID of the conversation

Request

This endpoint expects an object.

authorobjectRequired

Information about the message author

contentobjectRequired

The message content

Response

Message created

idstringRead-onlyformat: "id"

The ID of the message

conversation_idstringRead-onlyformat: "id"

The ID of the conversation

authorobject

Information about the message author

contentobject

The message content

created_atstringRead-onlyformat: "date-time"

The date and time the message was created

updated_atstringRead-onlyformat: "date-time"

The date and time the message was updated

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error