USusepylon
import

Migration only: Import an issue

Changed on

Migration only. This endpoint brings historical data into Pylon from another system and isn't meant for everyday writes. To create records as part of normal use, call POST /issues instead.

Imports an issue with its messages and metadata. At least one message is required. Imported messages keep the timestamps you send and don't kick off triggers, notifications, or AI side effects.

Rate limit: 120 requests per minute

post/import/issues

Request

  • Base URL
    https://api.usepylon.com
  • URL
    https://api.usepylon.com/import/issues
  • Auth
    HTTP bearer

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 date-time

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

first_response_timestring date-time

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.

partner_account_idstring

The ID of a partner account that serves account_id. Requires account_id.

requester_idstring

ContactID that the issue should be on behalf of. If omitted, the issue has no requester.

resolution_timestring date-time

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 date-time

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

Example request

{
  "state": "new"
}

Response

request_idstring required

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
    },
    "workspace_phone_number": "+14155551234"
  }
}

Changes

  • 05e40342a893Revision changes
    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

  • b64ce6c1bce3Revision changes
    • info

      added the optional property / to the response with the status