Tickets

Import a historical ticket

Backfills a past conversation with its original timestamps, status, and full message thread. Nothing is sent or triggered: no email, workflows, notifications, or automations run. Requires an admin token. Has its own rate limit of 300 requests per minute, separate from the standard API limit.

post/tickets/import

Request

  • Base URL: https://there-there.app/api
  • URL: https://there-there.app/api/tickets/import
  • Auth: HTTP bearer

Headers

X-Workspace-Idinteger

Workspace ID this request targets. Required for tokens that have access to multiple workspaces or to all workspaces. Optional for tokens scoped to a single workspace (auto-resolved). Find the ID under Settings > Account > API Tokens or Settings > Workspace > General.

Request body

channelstring required

Channel ULID.

subjectstring required
status'open' | 'waiting' | 'closed' | 'spam' required
created_atstring date-time nullable

When the ticket was originally created. Must be in the past. Defaults to the earliest message.

closed_atstring date-time nullable

When the ticket was resolved. Must be in the past. Used only when status is closed.

external_idstring nullable

Your own identifier for the ticket. Re-importing the same external_id returns the existing ticket.

assignee_emailstring email nullable

Email of a workspace member to assign. Ignored unless it is an active member with access to the channel.

tagsstring[]

Tag names to attach. A tag is created if it does not exist yet. Two names that only differ in punctuation cannot both exist, so a name the workspace already occupies answers 422 and the ticket is not imported.

Example request

{
  "messages": [
    {
      "attachment_ids": [
        "upl_screenshot_8f3c1a"
      ]
    }
  ]
}

Response

Ticket imported

Example response

{
  "data": {
    "custom_fields": [
      {
        "name": "Reported version",
        "options": [
          {
            "name": "Laravel",
            "color": "#FCA5A5",
            "icon": "flame"
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.