Creates multiple tags in a single request. Returns lists of successful and failed tag creations with detailed error reasons.

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\}/tags/bulk
• Summary: Bulk Create Tags
• Description: Creates multiple tags in a single request. Returns lists of successful and failed tag creations with detailed error reasons.
• 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.

{
  "tags": [
    {
      "attributes_keys": [
        "string"
      ],
      "filterable": false,
      "key": "string",
      "name": "string",
      "status": "active"
    }
  ]
}

{
  "data": {
    "failed": [
      {
        "key": "string",
        "reason": "string"
      }
    ],
    "successful": [
      {
        "attributes": [],
        "created_at": "string",
        "filterable": false,
        "id": "string",
        "key": "string",
        "markets": [],
        "name": "string",
        "schedules": [],
        "source_app_id": "string",
        "source_id": "string",
        "status": "string",
        "translations": {
          "name": null
        },
        "updated_at": "string"
      }
    ]
  },
  "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\}/tags/bulk
• Operation ID: Not documented in the OpenAPI contract.
• OpenAPI tag: Tags, Bulk
• OpenAPI summary: Bulk Create Tags