ticketing/comments

Create Comments

Create Comments in any supported Ticketing software

post/ticketing/comments

Query parameters

remote_databoolean

Set to true to include data from the original Ticketing software.

Headers

x-connection-tokenstring required

The connection token

Request body

bodystring nullable required

The body of the comment

html_bodystring nullable

The html body of the comment

is_privateboolean nullable

The public status of the comment

creator_typestring nullable

The creator type of the comment. Authorized values are either USER or CONTACT

ticket_idstring nullable

The UUID of the ticket the comment is tied to

contact_idstring nullable

The UUID of the contact which the comment belongs to (if no user_id specified)

user_idstring nullable

The UUID of the user which the comment belongs to (if no contact_id specified)

Example request

{
  "body": "Assigned to Eric !",
  "html_body": "<p>Assigned to Eric !</p>",
  "creator_type": "USER",
  "ticket_id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "contact_id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "user_id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "attachments": [
    "801f9ede-c698-4e66-a7fc-48d19eebaa4f"
  ]
}

Response

bodystring nullable required

The body of the comment

html_bodystring nullable

The html body of the comment

is_privateboolean nullable

The public status of the comment

creator_typestring nullable

The creator type of the comment. Authorized values are either USER or CONTACT

ticket_idstring nullable

The UUID of the ticket the comment is tied to

contact_idstring nullable

The UUID of the contact which the comment belongs to (if no user_id specified)

user_idstring nullable

The UUID of the user which the comment belongs to (if no contact_id specified)

idstring nullable

The UUID of the comment

remote_idstring nullable

The id of the comment in the context of the 3rd Party

remote_dataobject nullable

The remote data of the comment in the context of the 3rd Party

created_atstring date-time nullable

The created date of the object

modified_atstring date-time nullable

The modified date of the object

Example response

{
  "body": "Assigned to Eric !",
  "html_body": "<p>Assigned to Eric !</p>",
  "creator_type": "USER",
  "ticket_id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "contact_id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "user_id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "attachments": [
    "801f9ede-c698-4e66-a7fc-48d19eebaa4f"
  ],
  "id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "remote_id": "id_1",
  "remote_data": {
    "fav_dish": "broccoli",
    "fav_color": "red"
  },
  "created_at": "2024-10-01T12:00:00Z",
  "modified_at": "2024-10-01T12:00:00Z"
}

Changes

Changed in 7 of the 18 revisions of this API.52227

  • be3dc330edf322See the full diff
    • ▲

      removed the enum value CONTACT of the request property

      request-property-enum-value-removed

    • ▲

      removed the enum value USER of the request property

      request-property-enum-value-removed

    • ○

      removed the CONTACT enum value from the response property for the response status

      response-property-enum-value-removed

    • ○

      removed the USER enum value from the response property for the response status

      response-property-enum-value-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ▲

      the / request property type changed from string to no type

      request-property-type-changed

    • ▲

      added subschema #1 to the / response property oneOf list for the response status

      response-property-one-of-added

    • ▲

      the / response's property type changed from string to no type for status

      response-property-type-changed

    • ○

      added subschema #1 to the / request property oneOf list

      request-property-one-of-added

  • ca0fa45ebd05122See the full diff
    • ▲

      request property was restricted to a list of enum values

      request-property-became-enum

    • ●

      added the new CONTACT enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new USER enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new CONTACT enum value to the request property

      request-property-enum-value-added

    • ○

      added the new USER enum value to the request property

      request-property-enum-value-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • ca213ae36b7f189See the full diff
    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became optional for the status

      response-property-became-optional

    • ▲

      the response property became optional for the status

      response-property-became-optional

    • ▲

      the response property became optional for the status

      response-property-became-optional

    • ▲

      the response's property type changed from object to string, and format from no format to date-time for status

      response-property-type-changed

    • ▲

      the response's property type changed from object to string, and format from no format to date-time for status

      response-property-type-changed

    • ○

      the endpoint scheme security bearer was removed from the API

      api-security-removed

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      the request property became nullable

      request-property-became-nullable

    This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 167edd5346ec104See the full diff
    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the request property became not nullable

      request-property-became-not-nullable

    • ▲

      the response's property type changed from string to object, and format from date-time to no format for status

      response-property-type-changed

    • ▲

      the response's property type changed from string to object, and format from date-time to no format for status

      response-property-type-changed

    • ○

      the endpoint scheme security bearer was added to the API

      api-security-added

    • ○

      the response property became required for the status

      response-property-became-required

    • ○

      the response property became required for the status

      response-property-became-required

    • ○

      the response property became required for the status

      response-property-became-required

    This revision also has 8 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 9d25bd589fe9188See the full diff
    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became nullable for the status

      response-property-became-nullable

    • ▲

      the response property became optional for the status

      response-property-became-optional

    • ▲

      the response property became optional for the status

      response-property-became-optional

    • ▲

      the response property became optional for the status

      response-property-became-optional

    • ▲

      the response's property type changed from object to string, and format from no format to date-time for status

      response-property-type-changed

    • ▲

      the response's property type changed from object to string, and format from no format to date-time for status

      response-property-type-changed

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      the request property became nullable

      request-property-became-nullable

    • ○

      the request property became nullable

      request-property-became-nullable

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • ○

      the endpoint scheme security bearer was removed from the API

      api-security-removed