Create Request

POST {{baseUrl}}/api/v2/requests

Accepts a request object that sets one or more properties.

Allowed for

  • End users
  • Anonymous users (rate limit of 5 requests per hour for trial accounts)

Additional properties

In addition to the writable request properties in the JSON Format table above, you can set the following properties when creating a request.

NameTypeMandatoryComment
commentobjectyesDescribes the problem, incident, question, or task. See Request comments
collaboratorsarraynoAdds collaborators (cc's) to the request. An email notification is sent to them when the ticket is created. See Setting collaborators
requesterobjectyes**Required for anonymous requests. Specifies the requester of the anonymous request. See Creating anonymous requests

Creating follow-up requests

Once a ticket is closed (as distinct from solved), it can't be reopened. However, you can create a new request that references the closed ticket. To create the follow-up request, include a via_followup_source_id property in the request object that specifies the closed ticket. The parameter only works with closed tickets. It has no effect with other tickets.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: Created

{"request":{"custom_status_id":1,"description":"My printer is on fire!","id":33,"status":"new","subject":"Help!"}}