API Reference
  1. DeskDay API
  2. Tickets

Create a ticket

post
https://public-api.deskday.ai/v1/tickets

Creates a ticket. Requires scope tickets:write. Supports X-Idempotency-Key (replays within 24h return the original ticket with X-Idempotent-Replayed: true).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length between 1 and 255

Ticket subject. Required.

string
length ≤ 10000

Ticket description / body text.

string
length ≤ 64

Customer mapping_id; defaults to the MSP-converted customer when omitted.

string
length ≤ 64

Customer user (contact) mapping_id.

string
enum

Ticket priority; defaults to "low" when omitted.

Allowed:
string
length ≤ 64

Initial status — enum name (open, in_progress, pending) or UUID. Text is normalised to lower_snake_case.

string
length ≤ 64

Board mapping_id; the default board is applied when omitted.

string
length ≤ 64

Resource mapping_id to assign as ticket owner.

string
length ≤ 64

Site / location mapping_id; defaults to the customer's HQ site when omitted.

assignees
array of objects

Assignees with optional schedule times.

assignees
tag_ids
array of strings

Tag mapping_ids to apply to the ticket.

tag_ids
boolean

Whether the ticket is billable.

string
length ≤ 64

Source channel the ticket originated from (e.g. "rmm", "api", "email").

external_ref
object

External system reference linking the ticket to a third-party object.

participants
array of objects
length ≤ 50

CC members granted notification and chat-thread access. Maximum 50.

participants
Responses

Updated 2 months ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago

Did this page help you?