{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Create a tag. An account cannot have more than **500** unique tags.\n\nA tag belongs to a single tag group. If `relationships.tag-group.data.id` is not specified, the tag is added to the account's default tag group.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`\n\n**Scopes:**\n`tags:read`\n`tags:write`\n\n[OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/create_tag.json)","properties":{"query":{"type":"object","properties":{"fields[tag]":{"type":"array","items":{"type":"string","enum":["id","name"]},"description":"For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#sparse-fieldsets"}},"required":[],"additionalProperties":false},"headers":{"type":"object","properties":{"revision":{"type":"string","default":"2026-10-15","enum":["2026-10-15"],"description":"API endpoint revision (format: YYYY-MM-DD[.suffix])"}},"required":["revision"],"additionalProperties":false},"body":{"$ref":"#/definitions/TagCreateQuery"}},"required":["headers","body"],"additionalProperties":false,"definitions":{"TagCreateQuery":{"type":"object","properties":{"data":{"$ref":"#/definitions/TagCreateQueryResourceObject"}},"required":["data"]},"TagCreateQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/TagEnum"},"attributes":{"type":"object","properties":{"name":{"description":"The Tag name","type":"string","examples":["My Tag"]}},"required":["name"]},"relationships":{"type":"object","properties":{"tag-group":{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"$ref":"#/definitions/TagGroupEnum"},"id":{"description":"The ID of the Tag Group to associate the Tag with. If this field is not specified, the Tag will be associated with the company's Default Tag Group.","type":"string","examples":["zyxw9876-vu54-ts32-rq10-zyxwvu654321"]}},"required":["type","id"]}}}}}},"required":["type","attributes"]},"TagEnum":{"type":"string","enum":["tag"]},"TagGroupEnum":{"type":"string","enum":["tag-group"]}}},"name":"Create Tag","id":"klaviyo.create_tag","example":{"headers":{"revision":"2026-10-15"},"body":{"data":{"type":"tag","attributes":{"name":"My Tag"}}}},"maxRequests":1,"summary":false}}