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"
}

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

1	import requests
2
3	url = "https://example.ada.support/api/v2/conversations/conversation_id/messages/"
4
5	payload = {
6	"author": {
7	"role": "end_user",
8	"id": "5df263b7db5a7e6ea03fae9b",
9	"avatar": "https://www.gravatar.com",
10	"display_name": "Ada Lovelace"
11	},
12	"content": {
13	"type": "text",
14	"body": "Hello, how can I help you?"
15	}
16	}
17	headers = {
18	"Authorization": "Bearer <token>",
19	"Content-Type": "application/json"
20	}
21
22	response = requests.post(url, json=payload, headers=headers)
23
24	print(response.json())

1	{
2	"id": "5df263b7db5a7e6ea03fae9b",
3	"conversation_id": "5df263b7db5a7e6ea03fae9b",
4	"author": {
5	"role": "end_user",
6	"id": "5df263b7db5a7e6ea03fae9b",
7	"avatar": "https://www.gravatar.com",
8	"display_name": "Ada Lovelace"
9	},
10	"content": {
11	"type": "text",
12	"body": "Hello, how can I help you?"
13	},
14	"created_at": "2020-09-20T00:00:00+00:00",
15	"updated_at": "2020-09-20T00:00:00+00:00"
16	}