# Create Global Trade Item

Provide a new Global Trade Item with unique GTIN and name.

Endpoint: POST /globaltradeitems
Version: 1
Security: apiKey

## Request fields (application/json):

  - `gtin` (string, required)
    A 13 digit Global Trade Item Number that uniquely identifies the item
    Example: "5099206081901"

  - `name` (string, required)
    Human readable name of the item.
    Example: "Business Partner Update Browser"

## Response 200 fields (application/json):

  - `gtin` (string)
    A 13 digit Global Trade Item Number that uniquely identifies the item
    Example: "5099206081901"

  - `name` (string)
    Human readable name of the item.
    Example: "Business Partner Update Browser"

  - `businessPartnerReferences` (array)
    List of Business Partners that are referenced.

  - `businessPartnerReferences.storageId` (string)
    Unique identifier of the Storage.
    Example: "72d6900fce6b326088f5d9d91049e3e6"

  - `businessPartnerReferences.dataSourceId` (string)
    Unique identifier for a Data Source of the Storage.
    Example: "648824a691d8d2503d65103e"

  - `businessPartnerReferences.businessPartnerId` (string)
    A CDQ ID identifies a business partner uniquely in the context of the Corporate Data League.
    Example: "63e635235c06b7396330fe40"

  - `businessPartnerReferences.externalId` (string)
    Arbitrary identifier type to mark customer IDs that are "external" from CDQ's perspective. This is the identifier a customer provides to identify its records.
    Example: "The ID managed in the customer's SAP systems."

## Response 400 fields (application/json):

  - `path` (string)
    Requested path which caused this error.
    Example: "/v2/businesspartners/lookup"

  - `timestamp` (string)
    ISO 8601 representation of the timestamp.
    Example: "2025-08-29T09:47:03Z"

  - `message` (string)
    Details about the error.
    Example: "This user is not allowed to access this service."

  - `error` (string)
    RFC 7231 error which belongs to the status code.
    Example: "BAD_REQUEST"

  - `status` (integer)
    RFC 7231 status code for this error.
    Example: "400"