ticketing/tickets

Create Tickets

Changed on

Create Tickets in any supported Ticketing software

post/ticketing/tickets

Request

  • Base URL
    https://api.panora.dev
  • URL
    https://api.panora.dev/ticketing/tickets
  • Auth
    API key in header x-api-key

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

namestring nullable required

The name of the ticket

statusstring nullable

The status of the ticket. Authorized values are OPEN or CLOSED.

descriptionstring nullable required

The description of the ticket

due_datestring date-time nullable

The date the ticket is due

typestring nullable

The type of the ticket. Authorized values are PROBLEM, QUESTION, or TASK

parent_ticketstring nullable

The UUID of the parent ticket

completed_atstring date-time nullable

The date the ticket has been completed

prioritystring nullable

The priority of the ticket. Authorized values are HIGH, MEDIUM or LOW.

assigned_tostring[] nullable

The users UUIDs the ticket is assigned to

account_idstring nullable

The UUID of the account which the ticket belongs to

contact_idstring nullable

The UUID of the contact which the ticket belongs to

field_mappingsobject nullable

The custom field mappings of the ticket between the remote 3rd party & Panora

Example request

{
  "name": "Customer Service Inquiry",
  "status": "OPEN",
  "description": "Help customer",
  "due_date": "2024-10-01T12:00:00Z",
  "type": "BUG",
  "parent_ticket": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "collections": [
    "801f9ede-c698-4e66-a7fc-48d19eebaa4f"
  ],
  "tags": [
    "my_tag",
    "urgent_tag"
  ],
  "completed_at": "2024-10-01T12:00:00Z",
  "priority": "HIGH",
  "assigned_to": [
    "801f9ede-c698-4e66-a7fc-48d19eebaa4f"
  ],
  "comment": {
    "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"
    ]
  },
  "account_id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "contact_id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "attachments": [
    "801f9ede-c698-4e66-a7fc-48d19eebaa4f"
  ],
  "field_mappings": {
    "fav_dish": "broccoli",
    "fav_color": "red"
  }
}

Response

namestring nullable required

The name of the ticket

statusstring nullable

The status of the ticket. Authorized values are OPEN or CLOSED.

descriptionstring nullable required

The description of the ticket

due_datestring date-time nullable

The date the ticket is due

typestring nullable

The type of the ticket. Authorized values are PROBLEM, QUESTION, or TASK

parent_ticketstring nullable

The UUID of the parent ticket

completed_atstring date-time nullable

The date the ticket has been completed

prioritystring nullable

The priority of the ticket. Authorized values are HIGH, MEDIUM or LOW.

assigned_tostring[] nullable

The users UUIDs the ticket is assigned to

account_idstring nullable

The UUID of the account which the ticket belongs to

contact_idstring nullable

The UUID of the contact which the ticket belongs to

field_mappingsobject nullable

The custom field mappings of the ticket between the remote 3rd party & Panora

idstring nullable

The UUID of the ticket

remote_idstring nullable

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

remote_dataobject nullable

The remote data of the ticket 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

{
  "name": "Customer Service Inquiry",
  "status": "OPEN",
  "description": "Help customer",
  "due_date": "2024-10-01T12:00:00Z",
  "type": "BUG",
  "parent_ticket": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "collections": [
    "801f9ede-c698-4e66-a7fc-48d19eebaa4f"
  ],
  "tags": [
    "my_tag",
    "urgent_tag"
  ],
  "completed_at": "2024-10-01T12:00:00Z",
  "priority": "HIGH",
  "assigned_to": [
    "801f9ede-c698-4e66-a7fc-48d19eebaa4f"
  ],
  "comment": {
    "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"
    ]
  },
  "account_id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "contact_id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "attachments": [
    "801f9ede-c698-4e66-a7fc-48d19eebaa4f"
  ],
  "field_mappings": {
    "fav_dish": "broccoli",
    "fav_color": "red"
  },
  "id": "801f9ede-c698-4e66-a7fc-48d19eebaa4f",
  "remote_id": "id_1",
  "remote_data": {
    "key1": "value1",
    "key2": 42,
    "key3": true
  },
  "created_at": "2024-10-01T12:00:00Z",
  "modified_at": "2024-10-01T12:00:00Z"
}

Changes

  • be3dc330edf3Revision changes
    • breaking

      removed the enum value BUG of the request property

    • breaking

      removed the enum value CLOSED of the request property

    • breaking

      removed the enum value CONTACT of the request property /////

    • breaking

      removed the enum value HIGH of the request property

    • breaking

      removed the enum value LIST of the request property //////

    • breaking

      removed the enum value LOW of the request property

    • breaking

      removed the enum value MEDIUM of the request property

    • breaking

      removed the enum value OPEN of the request property

    • breaking

      removed the enum value PROJECT of the request property //////

    • breaking

      removed the enum value SUBTASK of the request property

    • breaking

      removed the enum value TASK of the request property

    • breaking

      removed the enum value TO-DO of the request property

    • breaking

      removed the enum value USER of the request property /////

    • info

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

    • info

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

    • info

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

    • info

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

    • info

      removed the LIST enum value from the ////// response property for the response status

    • info

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

    • info

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

    • info

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

    • info

      removed the PROJECT enum value from the ////// response property for the response status

    • info

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

    • info

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

    • info

      removed the TO-DO enum value from the response property for the response status

    • info

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

  • 6502b0fa098cRevision changes
    • breaking

      the / request property type changed from string to no type

    • breaking

      the request property type changed from string to array

    • breaking

      the ////// request property type changed from string to no type

    • breaking

      the / request property type changed from string to no type

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • info

      added subschema #1 to the / request property oneOf list

    • info

      added subschema #1 to the ////// request property oneOf list

    • info

      added subschema #1 to the / request property oneOf list