tickets

Create /tickets

Create a ticket. Required: subject. Optional: message, client, contact person, email, status, priority, type, assignees, departments, object, project, service, organization, CC fields, tags, react_time_from_client, and custom fields. Returns record with the detail projection.

POST

/tickets

Create /tickets

curl --request POST \
  --url https://default.hannacrm.app/api/v4/tickets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "admin": 123,
  "assignees": [
    "<string>"
  ],
  "bcc_emails": "<string>",
  "cc_contacts": [
    "<string>"
  ],
  "cc_emails": "<string>",
  "client": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "contact_person": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "custom_fields": [
    {
      "slug": "<string>",
      "value": "<any>"
    }
  ],
  "departments": [
    "<string>"
  ],
  "email": "<string>",
  "message": "<string>",
  "object": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "organization": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "priority": "<string>",
  "project": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "react_time_from_client": "<string>",
  "service": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "<string>",
  "subject": "<string>",
  "tags": "<string>",
  "type": "<string>"
}
'

{
  "record": {
    "assignees": [
      {}
    ],
    "bcc_emails": "<string>",
    "cc_contacts": [
      {}
    ],
    "cc_emails": "<string>",
    "client": [
      {}
    ],
    "contact_person": [
      {}
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "created_by": {
      "name": "<string>",
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "custom_fields": [
      {
        "slug": "<string>",
        "value": "<any>"
      }
    ],
    "departments": [
      {}
    ],
    "email": "<string>",
    "last_reply": "2023-11-07T05:31:56Z",
    "message": "<string>",
    "message_text": "<string>",
    "object": [
      {}
    ],
    "organization": [
      {}
    ],
    "organization_name": "<string>",
    "priority": [
      {}
    ],
    "project": [
      {}
    ],
    "react_time_from_client": "2023-11-07T05:31:56Z",
    "service": [
      {}
    ],
    "status": [
      {}
    ],
    "subject": "<string>",
    "tags": [
      {}
    ],
    "type": [
      {}
    ],
    "updated_at": "2023-11-07T05:31:56Z",
    "updated_by": {
      "name": "<string>",
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "uuid": "<string>"
  }
}

Authorizations

Authorizationstringheaderrequired

API key (Bearer token) created in Setup → API & MCP.

Body

admininteger

Internal staff creator ID (set automatically on API create).

assigneesstring[]

Responsible person staff UUIDs. On update, replaces the full assignee list when sent.

bcc_emailsstring

BCC email addresses (comma- or semicolon-separated).

cc_contactsstring[]

CC contact person UUIDs.

cc_emailsstring

CC email addresses (comma- or semicolon-separated).

clientstringrequired

Client UUID.

contact_personstring

Contact person UUID.

custom_fieldsobject[]

Custom field values by slug.

Show child attributes

departmentsstring[]

Department UUIDs. First department is stored on the main ticket row; all are synced to tickets_departments.

emailstring

Submitter email when no client/contact is linked.

messagestring

Initial ticket message body.

objectstring

Related object UUID.

organizationstring

Organization UUID.

prioritystring

Ticket priority UUID.

projectstring

Related project UUID.

react_time_from_clientstring

Client reaction time (ISO 8601).

servicestring

Ticket service UUID.

statusstring

Ticket status UUID or code_name. Defaults to tenant open status when omitted on create.

subjectstringrequired

Ticket subject.

tagsstring

Comma-separated tag names.

typestring

Ticket type picklist value UUID.

Response

Success

recordobject

Fields enabled for this documentation instance (projection enabled: feature, option, subdomain, closures) plus account-level form field visibility. Role- and user-level field overrides are not applied here, so an API key whose staff user has such overrides may receive fewer fields. A disabled field is omitted from the response object entirely; a present key with a null value means the record simply has no value.

Show child attributes

Still need help? Ask the team