Cách tạo API key trong n8n và gọi n8n public API

API key của n8n dùng để gọi n8n public API từ bên ngoài, ví dụ liệt kê, tạo hoặc publish workflow bằng script. Tạo key tại Settings > n8n API > Create an API key, đặt Label và Expiration, sao chép key ngay vì n8n chỉ hiển thị một lần, rồi gửi key trong header X-N8N-API-KEY.

Bài này hướng dẫn tạo API key trong n8n, gọi thử API và tạo credential n8n API để dùng trong workflow. Nếu bạn cần gọi API của dịch vụ khác từ n8n (chiều ngược lại), xem cách thêm API vào n8n; còn các bước dựng workflow có ở hướng dẫn tạo workflow trên n8n.

API n8n là gì?

API (Application Programming Interface) của n8n là tập quy tắc cho phép ứng dụng khác điều khiển n8n bằng lập trình. Thay vì thao tác tay trên giao diện, bạn dùng API để tạo, quản lý workflow, credential, tag hoặc lấy dữ liệu các lần chạy.

Vai trò và chức năng của API n8n

• Quản lý workflow từ bên ngoài: tạo, sửa, publish hoặc unpublish workflow.
• Quản lý credential: tạo, xóa thông tin xác thực cho các dịch vụ.
• Truy xuất dữ liệu: lấy danh sách workflow, executions và tài nguyên khác.
• Tích hợp hệ thống: nối n8n với ứng dụng nội bộ, công cụ CI/CD.

Khi nào cần tạo API key n8n?

• Tự động hóa nâng cao: điều khiển n8n từ ứng dụng khác, quản lý credential bằng script, lấy dữ liệu workflow để phân tích.
• Phát triển ứng dụng tùy chỉnh: ứng dụng của bạn cần tạo workflow động hoặc theo dõi trạng thái chạy.
• Backup và khôi phục tự động: workflow sao lưu cần API key để đọc danh sách workflow, credential, xem cách backup và restore workflow n8n.
• CI/CD: triển khai hoặc cập nhật workflow như một bước trong quy trình phát triển phần mềm.
• Giám sát và báo cáo: thu thập số lần chạy, lỗi để đưa sang hệ thống giám sát.

Nếu chỉ cần ứng dụng khác khởi động một workflow, dùng node Webhook sẽ đơn giản và an toàn hơn. API key dùng khi cần điều khiển chính n8n.

Lưu ý: n8n API không dùng được trong thời gian dùng thử n8n Cloud (docs: API authentication, truy cập 22/10/2026).

Cách tạo API key trong n8n

Bước 1: Mở Settings

Từ giao diện n8n, bấm vào biểu tượng tài khoản ở góc dưới bên trái và chọn Settings.

Bước 2: Chọn n8n API

Trong menu Settings, chọn mục n8n API. Đây là nơi quản lý các API key đã tạo. Bấm Create an API Key.

Bước 3: Điền thông tin API key

• Label: tên dễ hiểu theo mục đích, ví dụ “Backup hằng đêm”.
• Expiration: thời hạn của key (7, 30, 60, 90 ngày, tùy chỉnh hoặc không hết hạn). Nên chọn thời hạn vừa đủ dùng.
• Scopes: chỉ chọn được trên gói Enterprise. Ở các gói khác (kể cả bản Community tự host), API key có toàn quyền với mọi tài nguyên của tài khoản; ô Scopes hiện thông báo Upgrade như trong ảnh.

Bấm Save. API key chỉ hiện ra một lần: sao chép ngay và cất vào trình quản lý mật khẩu, vì sau khi đóng hộp thoại bạn không xem lại được.

Bấm Done sau khi đã sao chép.

Bước 4: Gọi thử n8n API

Gửi key trong header X-N8N-API-KEY. Base URL có dạng https://<tên-miền-n8n>/api/v1 với bản tự host, hoặc https://<tên>.app.n8n.cloud/api/v1 với n8n Cloud (docs: API authentication). Ví dụ lấy danh sách workflow:

curl -X GET "https://n8n.example.com/api/v1/workflows" \
  -H "accept: application/json" \
  -H "X-N8N-API-KEY: <API key của bạn>"

Trả về JSON danh sách workflow là key hoạt động. Báo 401 thì key sai, đã hết hạn hoặc bị xóa.

Cách tạo credential n8n API với API key

Muốn workflow trong n8n tự gọi n8n API (ví dụ workflow sao lưu chính nó), tạo một credential loại n8n API để node n8n dùng:

Bước 1: Mở hộp thoại tạo credential

Bấm nút Create rồi chọn Credential (ở bản 1.x là mũi tên cạnh nút Create Workflow > Create Credential).

Ảnh chụp ở bản n8n 1.x (còn công tắc Inactive). Ở n8n 2.x, nút Create nằm ở góc trên bên trái thanh menu và workflow dùng nút Publish.

Bước 2: Chọn n8n API

Trong hộp thoại Add new credential, tìm và chọn n8n API, bấm Continue.

Bước 3: Điền thông tin credential

• Tên credential: bấm vào tên ở đầu hộp thoại để đổi, ví dụ “n8n API – backup”.
• API Key: dán key vừa sao chép ở phần trên.
• Base URL: địa chỉ instance kèm /api/v1, ví dụ https://n8n.example.com/api/v1.

Bấm Save. Từ giờ node n8n trong workflow dùng credential này để đọc, tạo workflow, execution, credential qua API.

Những lưu ý khi tạo API key n8n

• Label rõ ràng: mỗi key một mục đích, đặt tên theo mục đích để biết key nào cần thu hồi.
• Expiration ngắn: tránh key không hết hạn nếu không thật cần, đặc biệt khi key có toàn quyền.
• Scopes (chỉ Enterprise): nếu có Scopes, cấp quyền tối thiểu, ví dụ chỉ workflow:read cho script báo cáo.
• Lưu trữ an toàn: key chỉ hiển thị một lần; không dán vào mã nguồn, không gửi qua chat, không chụp màn hình để lộ key.
• Rà soát định kỳ: xóa key không dùng nữa hoặc đã lộ.

Muốn chạy n8n 24/7 mà không tự cài? VPS n8n của Tino cài sẵn n8n trên VPS NVMe đặt tại Việt Nam; bạn vẫn có quyền root để cấu hình. Xem cấu hình và giá trên trang sản phẩm.

Kết luận

Tạo API key n8n chỉ mất vài thao tác ở Settings > n8n API. Điều cần nhớ: key ở gói không phải Enterprise có toàn quyền, nên đặt hạn dùng ngắn, cất key cẩn thận và xóa ngay khi không dùng.

Những câu hỏi thường gặp