Requests
Create Request
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.
| Name | Type | Mandatory | Comment |
|---|---|---|---|
| comment | object | yes | Describes the problem, incident, question, or task. See Request comments |
| collaborators | array | no | Adds collaborators (cc's) to the request. An email notification is sent to them when the ticket is created. See Setting collaborators |
| requester | object | yes* | *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.
post/api/v2/requests
Response
Created response
Example response
{
"request": {
"assignee_id": 72983,
"can_be_solved_by_me": false,
"collaborator_ids": [],
"created_at": "2009-07-20T22:55:29Z",
"description": "The fire is very colorful.",
"due_at": "2011-05-24T12:00:00Z",
"group_id": 8665,
"id": 35436,
"organization_id": 509974,
"priority": "normal",
"requester_id": 1462,
"status": "open",
"subject": "Help, my printer is on fire!",
"ticket_form_id": 2,
"type": "problem",
"updated_at": "2011-05-05T10:38:52Z",
"url": "https://company.zendesk.com/api/v2/requests/35436.json",
"via": {
"channel": "web"
}
}
}