Features
Company
Resources
© 2018 — 2024
API documentation
The Conversation object represents a conversation made with a contact. A contact can have as many conversations as necessary.
A conversation happens somewhere - on the phone, on a social network or a SMS application. This list is pulled from the Contact Field Types in the account of the user. Therefore, a conversation must have a contact field type id to be saved.
A conversation is made of one or more messages. The Message object contains the body of the conversation in itself. A Message can't be orphan and belongs to a Conversation.
GET /conversations
{
"data": [
{
"id": 1,
"object": "conversation",
"happened_at": "1977-06-09T02:00:51Z",
"messages": [
{
"id": 1,
"object": "message",
"content": "The other side of the conversation. Alice replied, so eagerly that the Mouse to tell me who YOU are, first.' 'Why?' said the Hatter. He came in with the Queen merely remarking that a moment's pause.",
"written_at": "1953-04-02T14:28:10Z",
"written_by_me": true,
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "Soledad",
"last_name": null,
"nickname": null,
"complete_name": "Soledad",
"initials": "S",
"gender": "Rather not say",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": true,
"avatar_url": "https:\/\/randomuser.me\/api\/portraits\/women\/37.jpg",
"default_avatar_color": "#ff9807"
}
},
"account": {
"id": 1
}
},
"conversation": {
"id": 1
},
"created_at": "2018-10-11T01:31:40Z",
"updated_at": "2018-10-11T01:31:40Z"
},
{
"id": 2,
"object": "message",
"content": "I should think it would like the largest telescope that ever was! Good-bye, feet!' (for when she caught it, and very soon finished it off. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *.",
"written_at": "1944-07-10T23:50:30Z",
"written_by_me": true,
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "Soledad",
"last_name": null,
"nickname": null,
"complete_name": "Soledad",
"initials": "S",
"gender": "Rather not say",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": true,
"avatar_url": "https:\/\/randomuser.me\/api\/portraits\/women\/37.jpg",
"default_avatar_color": "#ff9807"
}
},
"account": {
"id": 1
}
},
"conversation": {
"id": 1
},
"created_at": "2018-10-11T01:31:40Z",
"updated_at": "2018-10-11T01:31:40Z"
},
{
"id": 3,
"object": "message",
"content": "I used to come yet, please your Majesty,' said the Mouse was bristling all over, and both creatures hid their faces in their paws. 'And how many hours a day did you call him Tortoise--' 'Why did you.",
"written_at": "1943-12-31T14:17:43Z",
"written_by_me": false,
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "Soledad",
"last_name": null,
"nickname": null,
"complete_name": "Soledad",
"initials": "S",
"gender": "Rather not say",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": true,
"avatar_url": "https:\/\/randomuser.me\/api\/portraits\/women\/37.jpg",
"default_avatar_color": "#ff9807"
}
},
"account": {
"id": 1
}
},
"conversation": {
"id": 1
},
"created_at": "2018-10-11T01:31:40Z",
"updated_at": "2018-10-11T01:31:40Z"
},
{
"id": 4,
"object": "message",
"content": "I can't take more.' 'You mean you can't think! And oh, I wish you could keep it to the little creature down, and was delighted to find that she was coming to, but it had gone. 'Well! I've often seen.",
"written_at": "1961-04-09T17:17:50Z",
"written_by_me": true,
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "Soledad",
"last_name": null,
"nickname": null,
"complete_name": "Soledad",
"initials": "S",
"gender": "Rather not say",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": true,
"avatar_url": "https:\/\/randomuser.me\/api\/portraits\/women\/37.jpg",
"default_avatar_color": "#ff9807"
}
},
"account": {
"id": 1
}
},
"conversation": {
"id": 1
},
"created_at": "2018-10-11T01:31:40Z",
"updated_at": "2018-10-11T01:31:40Z"
},
{
"id": 5,
"object": "message",
"content": "I can kick a little!' She drew her foot as far down the little door into that beautiful garden--how IS that to be a queer thing, to be two people! Why, there's hardly enough of it altogether; but.",
"written_at": "1949-11-29T10:56:18Z",
"written_by_me": true,
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "Soledad",
"last_name": null,
"nickname": null,
"complete_name": "Soledad",
"initials": "S",
"gender": "Rather not say",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": true,
"avatar_url": "https:\/\/randomuser.me\/api\/portraits\/women\/37.jpg",
"default_avatar_color": "#ff9807"
}
},
"account": {
"id": 1
}
},
"conversation": {
"id": 1
},
"created_at": "2018-10-11T01:31:40Z",
"updated_at": "2018-10-11T01:31:40Z"
}
],
"contact_field_type": {
"id": 4,
"object": "contactfieldtype",
"name": "Twitter",
"fontawesome_icon": "fa fa-twitter-square",
"protocol": null,
"delible": true,
"type": null,
"account": {
"id": 1
},
"created_at": "2018-10-11T01:31:37Z",
"updated_at": "2018-10-11T01:31:37Z"
},
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "Soledad",
"last_name": null,
"nickname": null,
"complete_name": "Soledad",
"initials": "S",
"gender": "Rather not say",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": true,
"avatar_url": "https:\/\/randomuser.me\/api\/portraits\/women\/37.jpg",
"default_avatar_color": "#ff9807"
}
},
"account": {
"id": 1
}
},
"created_at": "2018-10-11T01:31:40Z",
"updated_at": "2018-10-11T01:31:40Z"
}
...
],
"links": {
"first": "https:\/\/app.monicahq.com\/api\/conversations?page=1",
"last": "https:\/\/app.monicahq.com\/api\/conversations?page=22",
"prev": null,
"next": "https:\/\/app.monicahq.com\/api\/conversations?page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 22,
"path": "https:\/\/app.monicahq.com\/api\/conversations",
"per_page": 15,
"to": 15,
"total": 317
}
}GET /contacts/:id/conversations
{
"data": [
{
"id": 1,
"object": "conversation",
"happened_at": "1977-06-09T00:00:00Z",
"messages": [
{
"id": 1,
"object": "message",
"content": "The other side of the conversation. Alice replied, so eagerly that the Mouse to tell me who YOU are, first.' 'Why?' said the Hatter. He came in with the Queen merely remarking that a moment's pause.",
"written_at": "1953-04-02T00:00:00Z",
"written_by_me": true,
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "Soledad",
"last_name": null,
"nickname": null,
"complete_name": "Soledad",
"initials": "S",
"gender": "Rather not say",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": true,
"avatar_url": "https:\/\/randomuser.me\/api\/portraits\/women\/37.jpg",
"default_avatar_color": "#ff9807"
}
},
"account": {
"id": 1
}
},
"conversation": {
"id": 1
},
"created_at": "2018-10-11T01:31:40Z",
"updated_at": "2018-10-11T01:31:40Z"
},
{
"id": 2,
"object": "message",
"content": "I should think it would like the largest telescope that ever was! Good-bye, feet!' (for when she caught it, and very soon finished it off. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *.",
"written_at": "1944-07-10T00:00:00Z",
"written_by_me": true,
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "Soledad",
"last_name": null,
"nickname": null,
"complete_name": "Soledad",
"initials": "S",
"gender": "Rather not say",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": true,
"avatar_url": "https:\/\/randomuser.me\/api\/portraits\/women\/37.jpg",
"default_avatar_color": "#ff9807"
}
},
"account": {
"id": 1
}
},
"conversation": {
"id": 1
},
"created_at": "2018-10-11T01:31:40Z",
"updated_at": "2018-10-11T01:31:40Z"
},
{
"id": 3,
"object": "message",
"content": "I used to come yet, please your Majesty,' said the Mouse was bristling all over, and both creatures hid their faces in their paws. 'And how many hours a day did you call him Tortoise--' 'Why did you.",
"written_at": "1943-12-31T00:00:00Z",
"written_by_me": false,
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "Soledad",
"last_name": null,
"nickname": null,
"complete_name": "Soledad",
"initials": "S",
"gender": "Rather not say",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": true,
"avatar_url": "https:\/\/randomuser.me\/api\/portraits\/women\/37.jpg",
"default_avatar_color": "#ff9807"
}
},
"account": {
"id": 1
}
},
"conversation": {
"id": 1
},
"created_at": "2018-10-11T01:31:40Z",
"updated_at": "2018-10-11T01:31:40Z"
},
{
"id": 4,
"object": "message",
"content": "I can't take more.' 'You mean you can't think! And oh, I wish you could keep it to the little creature down, and was delighted to find that she was coming to, but it had gone. 'Well! I've often seen.",
"written_at": "1961-04-09T00:00:00Z",
"written_by_me": true,
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "Soledad",
"last_name": null,
"nickname": null,
"complete_name": "Soledad",
"initials": "S",
"gender": "Rather not say",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": true,
"avatar_url": "https:\/\/randomuser.me\/api\/portraits\/women\/37.jpg",
"default_avatar_color": "#ff9807"
}
},
"account": {
"id": 1
}
},
"conversation": {
"id": 1
},
"created_at": "2018-10-11T01:31:40Z",
"updated_at": "2018-10-11T01:31:40Z"
},
{
"id": 5,
"object": "message",
"content": "I can kick a little!' She drew her foot as far down the little door into that beautiful garden--how IS that to be a queer thing, to be two people! Why, there's hardly enough of it altogether; but.",
"written_at": "1949-11-29T00:00:00Z",
"written_by_me": true,
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "Soledad",
"last_name": null,
"nickname": null,
"complete_name": "Soledad",
"initials": "S",
"gender": "Rather not say",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": true,
"avatar_url": "https:\/\/randomuser.me\/api\/portraits\/women\/37.jpg",
"default_avatar_color": "#ff9807"
}
},
"account": {
"id": 1
}
},
"conversation": {
"id": 1
},
"created_at": "2018-10-11T01:31:40Z",
"updated_at": "2018-10-11T01:31:40Z"
}
],
"contact_field_type": {
"id": 4,
"object": "contactfieldtype",
"name": "Twitter",
"fontawesome_icon": "fa fa-twitter-square",
"protocol": null,
"delible": true,
"type": null,
"account": {
"id": 1
},
"created_at": "2018-10-11T01:31:37Z",
"updated_at": "2018-10-11T01:31:37Z"
},
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "Soledad",
"last_name": null,
"nickname": null,
"complete_name": "Soledad",
"initials": "S",
"gender": "Rather not say",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": true,
"avatar_url": "https:\/\/randomuser.me\/api\/portraits\/women\/37.jpg",
"default_avatar_color": "#ff9807"
}
},
"account": {
"id": 1
}
},
"created_at": "2018-10-11T01:31:40Z",
"updated_at": "2018-10-11T01:31:40Z"
}
...
],
"links": {
"first": "https:\/\/app.monicahq.com\/api\/conversations?page=1",
"last": "https:\/\/app.monicahq.com\/api\/conversations?page=22",
"prev": null,
"next": "https:\/\/app.monicahq.com\/api\/conversations?page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 22,
"path": "https:\/\/app.monicahq.com\/api\/conversations",
"per_page": 15,
"to": 15,
"total": 317
}
}Retrieving a conversation contains all the messages of this conversation.
GET /conversations/:id
{
"data": {
"id": 3,
"object": "conversation",
"happened_at": "1981-10-29T00:00:00Z",
"messages": [
{
"id": 4,
"object": "message",
"content": "lorem ipsum",
"written_at": "1998-02-02T00:00:00Z",
"written_by_me": true,
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "John",
"last_name": "Doe",
"nickname": null,
"complete_name": "John Doe",
"initials": "JD",
"gender": "Man",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": false,
"avatar_url": null,
"default_avatar_color": "#93521e"
}
},
"account": {
"id": 1
}
},
"conversation": {
"id": 3
},
"created_at": "2018-08-19T19:29:09Z",
"updated_at": "2018-08-19T19:29:09Z"
}
],
"contact_field_type": {
"id": 1,
"object": "contactfieldtype",
"name": "Email",
"fontawesome_icon": "fa fa-envelope-open-o",
"protocol": "mailto:",
"delible": false,
"type": "email",
"account": {
"id": 1
},
"created_at": "2018-08-18T19:07:58Z",
"updated_at": "2018-08-18T19:07:58Z"
},
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "John",
"last_name": "Doe",
"nickname": null,
"complete_name": "John Doe",
"initials": "JD",
"gender": "Man",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": false,
"avatar_url": null,
"default_avatar_color": "#93521e"
}
},
"account": {
"id": 1
}
},
"created_at": "2018-08-19T19:15:03Z",
"updated_at": "2018-08-19T19:15:03Z"
}
}Creating a conversation only creates the conversation itself. You will have to add messages one by one to populate it with actual content.
POST /conversations/
| Name | Type | Description |
|---|---|---|
| happened_at | date | Required. The date the conversation happened. Format: YYYY-MM-DD. |
| contact_field_type_id | integer | Required. The type of the contact field. Has to be a valid, existing contact field type ID. You can retrieve the list of all the contact field types of an account via the API. |
| contact_id | integer | Required. The ID of the contact that the conversation field is associated with. |
{
"happened_at": "1981-10-29",
"contact_id": 1,
"contact_field_type_id": 1
}The API call returns a Conversation object if the call succeeds.
{
"data": {
"id": 3,
"object": "conversation",
"happened_at": "1981-10-29T00:00:00Z",
"messages": [],
"contact_field_type": {
"id": 1,
"object": "contactfieldtype",
"name": "Email",
"fontawesome_icon": "fa fa-envelope-open-o",
"protocol": "mailto:",
"delible": false,
"type": "email",
"account": {
"id": 1
},
"created_at": "2018-08-18T19:07:58Z",
"updated_at": "2018-08-18T19:07:58Z"
},
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "John",
"last_name": "Doe",
"nickname": null,
"complete_name": "John Doe",
"initials": "JD",
"gender": "Man",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": false,
"avatar_url": null,
"default_avatar_color": "#93521e"
}
},
"account": {
"id": 1
}
},
"created_at": "2018-08-19T19:15:03Z",
"updated_at": "2018-08-19T19:15:03Z"
}
}This only updates the conversation object itself - not the messages in the conversation.
PUT /conversations/:id
| Name | Type | Description |
|---|---|---|
| happened_at | date | Required. The date the conversation happened. Format: YYYY-MM-DD. |
{
"happened_at": "2019-10-29"
}{
"data": {
"id": 3,
"object": "conversation",
"happened_at": "1981-10-29T00:00:00Z",
"messages": [],
"contact_field_type": {
"id": 1,
"object": "contactfieldtype",
"name": "Email",
"fontawesome_icon": "fa fa-envelope-open-o",
"protocol": "mailto:",
"delible": false,
"type": "email",
"account": {
"id": 1
},
"created_at": "2018-08-18T19:07:58Z",
"updated_at": "2018-08-18T19:07:58Z"
},
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "John",
"last_name": "Doe",
"nickname": null,
"complete_name": "John Doe",
"initials": "JD",
"gender": "Man",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": false,
"avatar_url": null,
"default_avatar_color": "#93521e"
}
},
"account": {
"id": 1
}
},
"created_at": "2018-08-19T19:15:03Z",
"updated_at": "2018-08-19T19:15:03Z"
}
}DELETE /conversations/:id
The response sends back the id that was just deleted.
{
"deleted": true,
"id": 31
}POST /conversations/:id/messages
| Name | Type | Description |
|---|---|---|
| written_at | date | Required. The date the message has been written. Format: YYYY-MM-DD. |
| written_by_me | boolean | Required. True if the user has written the message. False if the contact has written the message. |
| content | text | Required. The actual message. |
| contact_id | integer | Required. The ID of the contact that the conversation is associated with. |
{
"contact_id": 1,
"written_at": "1998-02-02",
"written_by_me": true,
"content": "this is a message"
}The API call returns a Conversation object if the call succeeds.
{
"data": {
"id": 3,
"object": "conversation",
"happened_at": "1981-10-29T00:00:00Z",
"messages": [
{
"id": 4,
"object": "message",
"content": "this is a message",
"written_at": "1998-02-02T00:00:00Z",
"written_by_me": true,
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "John",
"last_name": "Doe",
"nickname": null,
"complete_name": "John Doe",
"initials": "JD",
"gender": "Man",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": false,
"avatar_url": null,
"default_avatar_color": "#93521e"
}
},
"account": {
"id": 1
}
},
"conversation": {
"id": 3
},
"created_at": "2018-08-19T19:29:09Z",
"updated_at": "2018-08-19T19:29:09Z"
}
],
"contact_field_type": {
"id": 1,
"object": "contactfieldtype",
"name": "Email",
"fontawesome_icon": "fa fa-envelope-open-o",
"protocol": "mailto:",
"delible": false,
"type": "email",
"account": {
"id": 1
},
"created_at": "2018-08-18T19:07:58Z",
"updated_at": "2018-08-18T19:07:58Z"
},
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "John",
"last_name": "Doe",
"nickname": null,
"complete_name": "John Doe",
"initials": "JD",
"gender": "Man",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": false,
"avatar_url": null,
"default_avatar_color": "#93521e"
}
},
"account": {
"id": 1
}
},
"created_at": "2018-08-19T19:15:03Z",
"updated_at": "2018-08-19T19:15:03Z"
}
}PUT /conversations/:id/messages/:id
| Name | Type | Description |
|---|---|---|
| written_at | date | Required. The date the message has been written. Format: YYYY-MM-DD. |
| written_by_me | boolean | Required. True if the user has written the message. False if the contact has written the message. |
| content | text | Required. The actual message. |
| contact_id | integer | Required. The ID of the contact that the conversation is associated with. |
{
"contact_id": 1,
"written_at": "1998-02-02",
"written_by_me": true,
"content": "this is a message"
}The API call returns a Conversation object if the call succeeds.
{
"data": {
"id": 3,
"object": "conversation",
"happened_at": "1981-10-29T00:00:00Z",
"messages": [
{
"id": 4,
"object": "message",
"content": "this is a message",
"written_at": "1998-02-02T00:00:00Z",
"written_by_me": true,
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "John",
"last_name": "Doe",
"nickname": null,
"complete_name": "John Doe",
"initials": "JD",
"gender": "Man",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": false,
"avatar_url": null,
"default_avatar_color": "#93521e"
}
},
"account": {
"id": 1
}
},
"conversation": {
"id": 3
},
"created_at": "2018-08-19T19:29:09Z",
"updated_at": "2018-08-19T19:29:09Z"
}
],
"contact_field_type": {
"id": 1,
"object": "contactfieldtype",
"name": "Email",
"fontawesome_icon": "fa fa-envelope-open-o",
"protocol": "mailto:",
"delible": false,
"type": "email",
"account": {
"id": 1
},
"created_at": "2018-08-18T19:07:58Z",
"updated_at": "2018-08-18T19:07:58Z"
},
"account": {
"id": 1
},
"contact": {
"id": 1,
"object": "contact",
"hash_id": "h:Y5LOkAdWNDqgVomKPv",
"first_name": "John",
"last_name": "Doe",
"nickname": null,
"complete_name": "John Doe",
"initials": "JD",
"gender": "Man",
"is_partial": false,
"is_dead": false,
"information": {
"birthdate": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"deceased_date": {
"is_age_based": null,
"is_year_unknown": null,
"date": null
},
"avatar": {
"has_avatar": false,
"avatar_url": null,
"default_avatar_color": "#93521e"
}
},
"account": {
"id": 1
}
},
"created_at": "2018-08-19T19:15:03Z",
"updated_at": "2018-08-19T19:15:03Z"
}
}DELETE /conversations/:id/messages/:id
The response sends back the id that was just deleted.
{
"deleted": true,
"id": 31
}Features
Company
Resources
© 2018 — 2024