Skip to main content
POST
/
unified
/
ticketing
/
tickets
Create Ticket
curl --request POST \
  --url https://api.stackone.com/unified/ticketing/tickets \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'x-account-id: <x-account-id>' \
  --data '{
  "unified_custom_fields": {
    "my_project_custom_field_1": "REF-1236",
    "my_project_custom_field_2": "some other value"
  },
  "title": "System outage in production environment",
  "creator_id": "user-001",
  "reporters": [
    "user-001",
    "user-002"
  ],
  "assignees": [
    "user-001",
    "user-002"
  ],
  "content": [
    {
      "plain": "This is some content",
      "html": "<p>This is some content</p>"
    }
  ],
  "parent_id": "ticket-002",
  "priority": {
    "id": "001",
    "value": "medium",
    "source_value": "Normal"
  },
  "tags": [
    "tag-001",
    "tag-002"
  ],
  "organization_id": "organization-001",
  "project_id": "project-001",
  "component_ids": [
    "component-001",
    "component-002"
  ],
  "type": "ticket-type-001"
}'
{
  "statusCode": 201,
  "message": "Record created successfully.",
  "timestamp": "2021-01-01T01:01:01.000Z",
  "data": {
    "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"
  }
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

​
x-account-id
string
required

The account identifier

Body

application/json
​
unified_custom_fields
object | null

Custom Unified Fields configured in your StackOne project

Example:
{
  "my_project_custom_field_1": "REF-1236",
  "my_project_custom_field_2": "some other value"
}
​
title
string | null

The title or subject of the ticket

Example:

"System outage in production environment"

​
creator_id
string | null

The creator of the ticket

Example:

"user-001"

​
reporters
string[] | null

Users who reported the ticket

Example:
["user-001", "user-002"]
​
assignees
string[] | null

Agents assigned to the ticket

Example:
["user-001", "user-002"]
​
content
object[] | null

Array of content associated with the ticket

​
parent_id
string | null

ID of the parent ticket if this is a sub-ticket

Example:

"ticket-002"

​
priority
object

Priority of the ticket

​
tags
string[] | null

The tags of the ticket

Example:
["tag-001", "tag-002"]
​
organization_id
string | null

Organization associated with the ticket

Example:

"organization-001"

​
project_id
string | null

Project the ticket belongs to

Example:

"project-001"

​
component_ids
string | null

Components to associate with the ticket

Example:
["component-001", "component-002"]
​
type
string | null

The type of the ticket

Example:

"ticket-type-001"

Response

Record created successfully.

​
statusCode
number
required
Example:

201

​
message
string
required
Example:

"Record created successfully."

​
timestamp
string<date-time>
required
Example:

"2021-01-01T01:01:01.000Z"

​
data
object
required