create-tag
Generate and manage tags in your n8n instance by specifying a client ID and tag name, enabling organized workflow and execution tracking for improved operational clarity.
Instructions
Create a new tag in your instance.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clientId | Yes | ||
| name | Yes |
Implementation Reference
- src/index.ts:1695-1724 (handler)Handler for the 'create-tag' tool that retrieves the N8nClient and calls its createTag method with the provided name, returning the created tag or error.const { clientId, name } = args as { clientId: string; name: string }; const client = clients.get(clientId); if (!client) { return { content: [{ type: "text", text: "Client not initialized. Please run init-n8n first.", }], isError: true }; } try { const tag = await client.createTag(name); return { content: [{ type: "text", text: `Successfully created tag:\n${JSON.stringify(tag, null, 2)}`, }] }; } catch (error) { return { content: [{ type: "text", text: error instanceof Error ? error.message : "Unknown error occurred", }], isError: true }; } }
- src/index.ts:735-745 (registration)Registration of the 'create-tag' tool in the ListTools response, defining its name, description, and input schema.name: "create-tag", description: "Create a new tag in your instance.", inputSchema: { type: "object", properties: { clientId: { type: "string" }, name: { type: "string" } }, required: ["clientId", "name"] } },
- src/index.ts:737-744 (schema)Input schema for the 'create-tag' tool specifying clientId and name parameters.inputSchema: { type: "object", properties: { clientId: { type: "string" }, name: { type: "string" } }, required: ["clientId", "name"] }
- src/index.ts:299-304 (helper)N8nClient helper method that performs the POST request to /tags endpoint to create a new tag.async createTag(name: string): Promise<N8nTag> { return this.makeRequest<N8nTag>('/tags', { method: 'POST', body: JSON.stringify({ name }), }); }