> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://support.atomicwork.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://support.atomicwork.com/_mcp/server.

# createServiceRequest

Create a service request from a service item.

Creates a new service request for a specific catalog item. If the target is an external ITSM and the user is not connected, returns 428 `EXTERNAL_AUTH_REQUIRED` with `authorization_url`; show it to the user and retry the same call after they connect.

## Parameters

| Name                      | Type                  | Required | Description                                                                                                              |
| ------------------------- | --------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------ |
| `itemId`                  | integer               | Yes      | The service item ID (from searchInternalKnowledgeAndCatalogs service_items or listServiceItems)                          |
| `item_id`                 | integer               | No       |                                                                                                                          |
| `item_fields`             | object                | No       |                                                                                                                          |
| `request_type`            | string                | No       |                                                                                                                          |
| `request_source`          | object                | No       |                                                                                                                          |
| `category`                | string                | No       |                                                                                                                          |
| `subcategory`             | string                | No       |                                                                                                                          |
| `cti_item`                | string                | No       |                                                                                                                          |
| `description`             | string                | No       |                                                                                                                          |
| `email_content`           | string                | No       |                                                                                                                          |
| `status`                  | string                | No       |                                                                                                                          |
| `priority`                | string                | No       |                                                                                                                          |
| `parent_request_id`       | integer               | No       |                                                                                                                          |
| `agent_group`             | integer               | No       | ID of the agent group to associate with the request. Members of this group are included in follower notifications when t |
| `assignee`                | integer               | No       | ID of the user assigned to the request.                                                                                  |
| `subject`                 | string                | No       |                                                                                                                          |
| `notes`                   | RequestNoteRequest\[] | No       |                                                                                                                          |
| `workspace_id`            | integer               | No       |                                                                                                                          |
| `conversation_info`       | object                | No       |                                                                                                                          |
| `tags`                    | integer\[]            | No       |                                                                                                                          |
| `cc_emails`               | string\[]             | No       |                                                                                                                          |
| `bcc_emails`              | string\[]             | No       |                                                                                                                          |
| `attachments`             | integer\[]            | No       |                                                                                                                          |
| `requester`               | integer               | No       |                                                                                                                          |
| `to_email`                | string                | No       |                                                                                                                          |
| `request_created_from`    | object                | No       |                                                                                                                          |
| `custom_fields`           | object                | No       |                                                                                                                          |
| `created_at`              | string (date-time)    | No       |                                                                                                                          |
| `updated_at`              | string (date-time)    | No       |                                                                                                                          |
| `external_id`             | string                | No       |                                                                                                                          |
| `external_source`         | object                | No       |                                                                                                                          |
| `resolution_time`         | string (date-time)    | No       | When the ticket was resolved in the source system. Only accepted during migration (requires external_id or external_sour |
| `first_response_time`     | string (date-time)    | No       | When the first agent response occurred in the source system. Only accepted during migration (requires external_id or ext |
| `first_response_due_time` | string (date-time)    | No       | SLA due time for first response from the source system. Only accepted during migration (requires external_id or external |
| `resolution_due_time`     | string (date-time)    | No       | SLA due time for resolution from the source system. Only accepted during migration (requires external_id or external_sou |
| `closed_status_at`        | string (date-time)    | No       | When the ticket was moved to closed status in the source system. Only accepted during migration (requires external_id or |