Creates a ticket asynchronously. THIS IS THE RECOMMENDED WAY to open a ticket.

POST

/v1/integration/tickets

curl --request POST \
  --url https://api.ornek.com/v1/integration/tickets \
  --header 'Content-Type: application/json' \
  --data '{ "poolId": "example", "subject": "example", "description": "example", "priority": "example", "requesterFullName": "example", "requesterEmailAddress": "example", "requesterPhoneNumber": "example" }'

• Yer tutucu: kendi kurulumunuzun API adresiyle değiştirin.

Returns 202 immediately with a trackingKey; pool-default resolution, assignment and the welcome e-mail run off your request path. Resolve the result with GET /v1/integration/tickets/by-tracking-key/{trackingKey} — a 404 there means the ticket has not been created yet, so retry with a short backoff.

Send an Idempotency-Key header to make retries safe: the same key with the same body returns the original response and creates nothing; the same key with a different body returns 409. The claim is atomic, so concurrent retries with the same key still produce exactly one ticket. The key is remembered for 24 hours.

poolId selects which of your token’s permitted pools to create in. Optional for a token scoped to exactly one pool (defaults to it); REQUIRED for a token scoped to several pools or to all pools. A pool outside your token’s scope answers 403. The ticket source still comes only from your token — never send it.

Parameters

Header Parameters

Idempotency-Key

string

Request Body^required

object

poolId

nullable /^-?(?:0|[1-9]\d*)$/

subject

string

nullable

description

string

nullable

priority

string

nullable

requesterFullName

string

nullable

requesterEmailAddress

string

nullable

requesterPhoneNumber

string

nullable

Example^generated

{
  "poolId": "example",
  "subject": "example",
  "description": "example",
  "priority": "example",
  "requesterFullName": "example",
  "requesterEmailAddress": "example",
  "requesterPhoneNumber": "example"
}

object

poolId

nullable /^-?(?:0|[1-9]\d*)$/

subject

string

nullable

description

string

nullable

priority

string

nullable

requesterFullName

string

nullable

requesterEmailAddress

string

nullable

requesterPhoneNumber

string

nullable

Example^generated

{
  "poolId": "example",
  "subject": "example",
  "description": "example",
  "priority": "example",
  "requesterFullName": "example",
  "requesterEmailAddress": "example",
  "requesterPhoneNumber": "example"
}

object

poolId

nullable /^-?(?:0|[1-9]\d*)$/

subject

string

nullable

description

string

nullable

priority

string

nullable

requesterFullName

string

nullable

requesterEmailAddress

string

nullable

requesterPhoneNumber

string

nullable

Example^generated

{
  "poolId": "example",
  "subject": "example",
  "description": "example",
  "priority": "example",
  "requesterFullName": "example",
  "requesterEmailAddress": "example",
  "requesterPhoneNumber": "example"
}

Responses

202

Accepted

object

data

One of:

object

object

trackingKey

string

status

string

success

boolean

error

One of:

object

object

status

/^-?(?:0|[1-9]\d*)$/

code

string

nullable

details

message

string

object

data

One of:

object

object

trackingKey

string

status

string

success

boolean

error

One of:

object

object

status

/^-?(?:0|[1-9]\d*)$/

code

string

nullable

details

message

string

Example^generated

{
  "data": {
    "trackingKey": "example",
    "status": "example"
  },
  "success": true,
  "error": {
    "status": "example",
    "code": "example",
    "details": "example",
    "message": "example"
  }
}

object

data

One of:

object

object

trackingKey

string

status

string

success

boolean

error

One of:

object

object

status

/^-?(?:0|[1-9]\d*)$/

code

string

nullable

details

message

string

Example^generated

{
  "data": {
    "trackingKey": "example",
    "status": "example"
  },
  "success": true,
  "error": {
    "status": "example",
    "code": "example",
    "details": "example",
    "message": "example"
  }
}

401

Unauthorized

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

403

Forbidden

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

409

Conflict

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

422

Unprocessable Entity

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

429

Too Many Requests

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}

object

type

string

nullable

title

string

nullable

status

nullable /^-?(?:0|[1-9]\d*)$/

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": "example",
  "detail": "example",
  "instance": "example"
}