Tickets

Create a ticket

Creates a workspace-scoped ticket. The authenticated API key creator becomes the ticket actor and initial creator.

post/v1/tickets

Request

  • Base URL: https://api.entergram.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.entergram.com/v1/tickets
  • Auth: API key in header X-API-Key

Request body

assignedToIdstring

Optional workspace member id to assign immediately.

commentstring

Optional short operator note stored directly on the ticket.

customFieldsobject

Workspace ticket custom fields keyed by columnKey.

datestring date-time

Optional RFC3339 timestamp stored in the ticket date field.

descriptionstring

Optional long-form description.

linkedChatIdsstring[] nullable

Telegram chat ids to link on creation.

prioritystring

Initial priority. Defaults to MEDIUM.

statusstring

Initial status. Defaults to OPEN.

titlestring required

Ticket title shown in operator UI and API responses.

Example request

{
  "assignedToId": "user_demo_123",
  "comment": "Escalate if no response within 48h",
  "date": "2026-03-30T10:00:00Z",
  "description": "Synthetic customer asked for a walkthrough next week.",
  "priority": "HIGH",
  "status": "OPEN",
  "title": "Review onboarding request"
}

Response

Created

Example response

{
  "data": {
    "assignedTo": {
      "displayName": "Alex Example",
      "email": "alex@example.test",
      "id": "user_demo_123"
    },
    "attachmentCount": 1,
    "closedBy": {
      "displayName": "Alex Example",
      "email": "alex@example.test",
      "id": "user_demo_123"
    },
    "comment": "Sample escalation note",
    "commentCount": 3,
    "createdBy": {
      "displayName": "Alex Example",
      "email": "alex@example.test",
      "id": "user_demo_123"
    },
    "customFields": [
      {
        "columnKey": "source_campaign"
      }
    ],
    "description": "Synthetic customer asked for a follow-up next week.",
    "displayId": "#42",
    "id": "ticket_demo_123",
    "legacyTicketHash": "#TKT-001",
    "priority": "HIGH",
    "status": "OPEN",
    "ticketHash": "#42",
    "ticketNumber": 42,
    "title": "Review onboarding request",
    "userId": "user_demo_123",
    "workspaceId": "workspace_demo_123"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.