Sign in
ticket-forms

Submit a ticket form

Creates an issue from a configured ticket form. Provide either requester_id or both requester_email and requester_name. Field types are inferred from the ticket form; use value for single-value fields and values for multi-value and file-upload fields.

Rate limit: 30 requests per minute

post/ticket-forms/{id}/submissions

Path parameters

idstring required

The ID of the ticket form to submit.

Request body

attachment_urlsstring[]

HTTPS URLs to attach to the initial ticket message. URLs are copied into durable Pylon storage before the submission is persisted.

requester_emailstring

The requester's email address. Must be provided with requester_name and cannot be combined with requester_id.

requester_idstring

The ID of an existing contact to use as the requester. Provide either requester_id or both requester_email and requester_name.

requester_namestring

The requester's full name. Must be provided with requester_email and cannot be combined with requester_id.

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
    }
  }
}

Changes