Sign in
latestOpenAPI 3.0.32026-08-20147323331.7 KB

a7231589e927

import

Import an issue

Imports an issue with its messages and metadata. At least one message is required.

Rate limit: 20 requests per minute

post/import/issues

Request body

account_idstring

AccountID that the issue should belong to.

assignee_idstring

UserID that the issue should be assigned to.

attachment_urlsstring[]

An array of attachment URLs to attach to this issue.

created_atstring

CreatedAt is the time the issue was created (RFC3339).

first_response_timestring

FirstResponseTime is the time the issue was first responded to (RFC3339).

issue_numberinteger

An optional issue number to preserve from the platform the issue is being imported from. Usually, do not set this field. Pylon normally assigns its own auto-incrementing ticket numbers. Use it only for customers who require their historical ticket numbers to be preserved. When set, it must be positive and lower than the organization's current ticket number counter.

requester_idstring

ContactID that the issue should be on behalf of.

resolution_timestring

ResolutionTime is the time the issue was resolved (RFC3339).

statestring required

The state of the issue. Standard values are new, waiting_on_you, waiting_on_customer, on_hold, and closed; custom status slugs are also supported.

tagsstring[]

An array of strings to use as tags on this issue.

team_idstring

TeamID that the issue should be assigned to.

titlestring required

The title of the issue.

updated_atstring

UpdatedAt is the time the issue was last updated (RFC3339).

Example request

{
  "state": "new"
}

Response

request_idstring

The request ID for tracking.

Example response

{
  "data": {
    "business_hours_time_in_status_seconds": {
      "new": 120,
      "waiting_on_customer": 1800
    },
    "custom_fields": {
      "priority": {
        "value": "high"
      }
    },
    "state": "new",
    "time_in_status_seconds": {
      "new": 120,
      "waiting_on_customer": 3600
    }
  }
}