n8n Integration¶

Use Jobko tools in your n8n workflows.

Setup¶

1. Create a Credential¶

Go to Settings → Credentials
Click Add Credential
Select Header Auth
Configure:
Name: Jobko API
Header Name: Authorization
Header Value: Bearer jk_YOUR_KEY

2. Add HTTP Request Node¶

Add an HTTP Request node to your workflow
Configure it for Jobko API calls

Basic Configuration¶

Field	Value
Method	`POST`
URL	`https://jobko.ai/api/mcp/tools/call`
Authentication	Header Auth → Jobko API
Body Content Type	JSON

Example: Analyze a Job¶

Request Body¶

{
  "name": "analyze_job",
  "arguments": {
    "job_url": "{{ $json.job_url }}"
  }
}

Node Configuration¶

HTTP Request node:
Method: POST
URL: https://jobko.ai/api/mcp/tools/call
Authentication: Header Auth (Jobko API)
Body: JSON with the above content

Example: Get User Profile¶

Request Body¶

{
  "name": "get_profile",
  "arguments": {}
}

Example: Generate CV¶

Request Body¶

{
  "name": "generate_cv",
  "arguments": {
    "job_id": {{ $json.job_id }},
    "format": "pdf"
  }
}

Complete Workflow Example¶

Job Analysis Pipeline¶

[Webhook] → [HTTP Request: Analyze Job] → [IF: Match Score > 70] → [HTTP Request: Generate CV] → [Email]

Webhook: Receives job URL
HTTP Request: Calls analyze_job
IF: Checks if match score is above threshold
HTTP Request: Calls generate_cv for good matches
Email: Sends CV to user

Workflow JSON¶

{
  "nodes": [
    {
      "name": "Webhook",
      "type": "n8n-nodes-base.webhook",
      "parameters": {
        "path": "analyze-job"
      }
    },
    {
      "name": "Analyze Job",
      "type": "n8n-nodes-base.httpRequest",
      "parameters": {
        "method": "POST",
        "url": "https://jobko.ai/api/mcp/tools/call",
        "authentication": "headerAuth",
        "bodyContentType": "json",
        "body": "={\"name\": \"analyze_job\", \"arguments\": {\"job_url\": \"{{ $json.job_url }}\"}}"
      }
    }
  ]
}

Error Handling¶

Check for Errors¶

Add an IF node after the HTTP Request:

Condition: {{ $json.error }} is not empty
True: Handle error
False: Continue processing

Common Errors¶

Status	Meaning	Action
401	Invalid API key	Check credentials
402	No credits	Add credits at dashboard
429	Rate limited	Add delay, retry later

Tips¶

Use variables

Store your API key as an n8n credential rather than hardcoding it in nodes.

Add error handling

Always add IF nodes to check for errors before processing results.

Rate limiting

Add a Wait node if making multiple requests to avoid rate limits.