Skip to main content

​
Step 1 — Get a JWT token

Sign in with your email and password to receive a JWT valid for 24h. 
curl -X POST https://app.tarefy.com/nodeapi/v2/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "your-email@company.com",
    "password": "your-password"
  }'

const res = await fetch('https://app.tarefy.com/nodeapi/v2/auth/login', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    email: 'your-email@company.com',
    password: 'your-password',
  }),
});
const { token } = await res.json();

import requests
res = requests.post(
    'https://app.tarefy.com/nodeapi/v2/auth/login',
    json={'email': 'your-email@company.com', 'password': 'your-password'}
)
token = res.json()['token']
The response includes a token field — store it and send on every subsequent request.

​
Step 2 — List your tasks

Pass the token in the Authorization header: 
curl https://app.tarefy.com/nodeapi/v2/tasks \
  -H "Authorization: Bearer YOUR_TOKEN"

const tasks = await fetch('https://app.tarefy.com/nodeapi/v2/tasks', {
  headers: { Authorization: `Bearer ${token}` },
}).then(r => r.json());

tasks = requests.get(
    'https://app.tarefy.com/nodeapi/v2/tasks',
    headers={'Authorization': f'Bearer {token}'}
).json()

​
Step 3 — Create a task

curl -X POST https://app.tarefy.com/nodeapi/v2/tasks \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My first task via API",
    "description": "Created using the quickstart guide"
  }'

await fetch('https://app.tarefy.com/nodeapi/v2/tasks', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'My first task via API',
    description: 'Created using the quickstart guide',
  }),
});

​
Next steps

Advanced authentication

Token expiry, refresh, management

Full reference

All endpoints documented