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

# createObjectType

Create a new custom object type.

Creates a new custom object type definition for the tenant. **What is an Object Type?**
An object type is a schema definition (e.g., "Visa", "Invoice", "Travel Request")
that defines what kind of custom objects can be created.

## Parameters

| Name                | Type    | Required | Description                                                             |
| ------------------- | ------- | -------- | ----------------------------------------------------------------------- |
| `name`              | string  | Yes      | Display name for the object type                                        |
| `description`       | string  | No       | Optional description                                                    |
| `logo_url`          | string  | No       | Optional logo URL                                                       |
| `icon`              | object  | No       |                                                                         |
| `display_id_prefix` | string  | No       | Display ID prefix for instances (e.g., "VEN" for Vendor → VEN-1).       |
| `scope`             | object  | No       |                                                                         |
| `workspace_id`      | integer | No       | Workspace ID for WORKSPACE-scoped types. Required when scope=WORKSPACE, |