n8n

Connect Blue to n8n to exchange data with other applications through workflows.

n8n is an open-source workflow automation tool with hundreds of integrations. Connect it to Blue to send events and data between Blue and other applications.

How it connects

Blue and n8n communicate through the Blue public API and webhooks. n8n listens for events, makes requests, and routes data.

There are two directions:

  • Blue to n8n: A Blue webhook triggers an n8n workflow after record changes, automation runs, or form submissions.
  • n8n to Blue: An n8n workflow calls the Blue GraphQL API to create or update records, attach files, or post comments.

Trigger an n8n workflow from Blue

  1. Create a workflow in n8n.
  2. Add a Webhook node to the start of the workflow.
  3. Copy the URL generated by the node.
  4. In Blue, open the workspace Automations panel.
  5. Select a trigger, such as a record creation, status change, field update, or schedule.
  6. Add an HTTP Request action.
  7. Enter the n8n webhook URL in the action.
  8. If the request must contain record data, add variables such as {Name} or {Status} to the body.
  9. Select Save. Blue sends the webhook when the trigger conditions are met.

Call Blue from n8n

  1. Generate a Personal Access Token under Account > API.
  2. Add an HTTP Request node in n8n.
  3. Set the node URL to https://api.blue.app/graphql.
  4. Set the request method to POST.
  5. Add Content-Type: application/json.
  6. Add blue-token-id: YOUR_TOKEN_ID.
  7. Add blue-token-secret: YOUR_TOKEN_SECRET.
  8. Add blue-org-id: YOUR_ORG_ID_OR_SLUG.
  9. Add blue-workspace-id: YOUR_WORKSPACE_ID_OR_SLUG when the operation needs workspace context.
  10. Enter a GraphQL mutation or query in the node body. See the API documentation for available operations.

Example workflows

  • Slack to Blue: A Slack /task command triggers n8n to create a record in a Blue workspace.
  • Blue to Sheets: A record status change to Done triggers n8n to append a row to a Google Sheet.
  • Form to Blue to email: An external form sends data to n8n. n8n creates a Blue record and sends a confirmation email.
  • Stripe to Blue: A successful Stripe payment triggers n8n to mark the linked Blue record as paid.

Behavior

  • Self-hosted and cloud n8n instances can use the Blue API if they can reach api.blue.app.
  • Blue API rate limits apply to requests from n8n. See the API documentation for current limits.
  • For other integration platforms, see Zapier, Make, and Pabbly Connect.