n8n_create_credential
Store API credentials for services like GitHub, Slack, or databases in n8n. Provide credential type, name, and authentication data to enable workflow connections.
Instructions
Store new API credentials for services like GitHub, Slack, or databases. Provide credential type, descriptive name, and authentication data. Use get_credential_schema first to see required fields for each type.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Descriptive name (e.g., "Production GitHub Token") | |
| type | Yes | Credential type from get_credential_schema (e.g., githubApi, slackApi) | |
| data | Yes | Authentication data (API keys, OAuth tokens, passwords) |
Implementation Reference
- src/n8n-client.ts:132-137 (handler)The createCredential method in N8nClient class is the actual handler that executes the tool logic. It makes a POST request to the n8n API endpoint /api/v1/credentials with the credential data as JSON body.
async createCredential(credential: any) { return this.request(`${this.apiBase}/credentials`, { method: 'POST', body: JSON.stringify(credential), }); } - src/tools.ts:266-285 (schema)Tool schema definition for n8n_create_credential. Defines the tool name, description, inputSchema with required properties (name, type, data), and annotations including title 'Create Credential'.
{ name: 'n8n_create_credential', description: 'Store new API credentials for services like GitHub, Slack, or databases. Provide credential type, descriptive name, and authentication data. Use get_credential_schema first to see required fields for each type.', inputSchema: { type: 'object', properties: { name: { type: 'string', description: 'Descriptive name (e.g., "Production GitHub Token")' }, type: { type: 'string', description: 'Credential type from get_credential_schema (e.g., githubApi, slackApi)' }, data: { type: 'object', description: 'Authentication data (API keys, OAuth tokens, passwords)' }, }, required: ['name', 'type', 'data'], }, annotations: { title: 'Create Credential', readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true, }, }, - src/server.ts:57-58 (registration)Registration of the tool handler in the handleToolCall function. Routes 'n8n_create_credential' tool calls to client.createCredential(args).
case 'n8n_create_credential': return client.createCredential(args); - src/n8n-client.ts:25-47 (helper)The private request method is a helper utility that handles authenticated API calls to n8n. It adds the X-N8N-API-KEY header, sets Content-Type, handles timeouts, and throws errors for non-OK responses.
private async request<T>( endpoint: string, options: RequestInit = {} ): Promise<T> { const url = `${this.config.apiUrl}${endpoint}`; const response = await fetch(url, { ...options, signal: AbortSignal.timeout(this.timeout), headers: { 'X-N8N-API-KEY': this.config.apiKey, 'Content-Type': 'application/json', ...options.headers, }, }); if (!response.ok) { const error = await response.text(); throw new Error(`n8n API Error (${response.status}): ${error}`); } return response.json() as Promise<T>; } - src/types.ts:37-44 (schema)TypeScript interface N8nCredential defines the structure of credential objects with id, name, type, data, createdAt, and updatedAt fields.
export interface N8nCredential { id: string; name: string; type: string; data?: any; createdAt: string; updatedAt: string; }