Creates a new attribute using the specified template. Field values are validated against the template's field definitions (e.g., image fields require valid images, number fields must be numeric). For each template image field, send a file part using the field key, or a public image URL in the same form key, or reference an existing app image by UUID: use form field image_id when the field key is image, otherwise _image_id (e.g. hero_image_id).

API ownership

• API family: Management API
• Best for: Trusted back-office workflows that create, update, organize, or delete merchant-owned data.
• Do not use from: Browser-only storefront code or public clients.
• Guide route: /apis/management/latest

The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.

Operation

• Method: POST
• Path: /api/v1/\{team_slug\}/\{app_slug\}/attributes/\{attribute_template_key\}
• Summary: Create attribute
• Description: Creates a new attribute using the specified template. Field values are validated against the template's field definitions (e.g., image fields require valid images, number fields must be numeric). For each template image field, send a file part using the field key, or a public image URL in the same form key, or reference an existing app image by UUID: use form field image_id when the field key is image, otherwise _image_id (e.g. hero_image_id).
• OpenAPI contract: management-api
• Operation ID: Not documented in the OpenAPI contract.

Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.

{
  "key": "string",
  "name": "string",
  "description": "string"
}

{
  "data": {
    "created_at": "string",
    "description": "string",
    "filterable": false,
    "id": "string",
    "key": "string",
    "name": "string",
    "template_key": "string",
    "template_name": "string",
    "translatable": false,
    "translations": {
      "description": [
        {
          "id": null,
          "locale": null,
          "value": null
        }
      ],
      "name": [
        {
          "id": null,
          "locale": null,
          "value": null
        }
      ]
    },
    "updated_at": "string",
    "values": {}
  },
  "details": [
    "string"
  ],
  "success": false
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

Contract identity

Use these fields to confirm you are implementing the intended endpoint contract.

• API family: Management API
• Method: POST
• Path: /api/v1/\{team_slug\}/\{app_slug\}/attributes/\{attribute_template_key\}
• Operation ID: Not documented in the OpenAPI contract.
• OpenAPI tag: Attributes
• OpenAPI summary: Create attribute