Create a human task

A human task is something a person on the team does for one lead: a call, a voice note, a follow-up, a review or research. It comes from a human_task step of a flow (the sequence waits until the task has an outcome), after a positive or negative reply (branch on_reply of the flow), or you create one (a call script, a briefing). The user sees them under Human tasks in the menu, below the Inbox, and logs outcomes there or through you. These routes are the tools list_human_tasks, create_human_task and complete_human_task of the assistant server. A task is free; only finding a phone number (POST /person/phone) costs the normal price.

Authentication#

Send Authorization: Bearer gtk_…. Create the key under API keys in the menu. Every gtk_ key can call these routes, also while the Signals API is closed. A missing, invalid or revoked key is 401.

Body parameters#

• kind string · required — What kind of task. One of: call, voice_note, follow_up, review, research, custom.
• instruction string · required — What to do, up to 2000 characters: for a call, the call script or briefing.
• reason string — Why now, up to 300 characters.
• id string — The person: a row of GET /tables/leads (a number, sav_… or per_…).
• lead_id integer — Or a lead from the signals.
• linkedin_url string — Or a LinkedIn profile URL (with name if they are not in Leads).
• name / company / title / email / phone string — The person as you know them; name alone is enough without a profile.
• due_at / deadline_at string — From when it is due (default now) and when it is overdue, ISO 8601.
• owner string — me (default), or the email or id of a member (GET /team).
• external_id string — Your own id: the same id creates the task once.

Response#

• object string · required — Always human_task. One of: human_task.
• id string · required — The id of the task.
• source string · required — flow (a step of a sequence, which waits on it), reply (after a reply) or adhoc (created by you or the user). One of: flow, reply, adhoc.
• kind string · required — What kind of task. One of: call, voice_note, follow_up, review, research, custom.
• instruction / reason string / string | null · required — What to do, and why now.
• status string · required — open, or its outcome: done_positive, done_negative, no_answer (after the last attempt), skipped, or cancelled (the sequence stopped or the lead replied first). One of: open, done_positive, done_negative, no_answer, skipped, cancelled.
• name / company / title / linkedin_url / email / phone string | null · required — The person.
• phone_needed boolean · required — A call without a known number that waits for one (if_no_phone: find_phone): POST /person/phone with its linkedin_url; the number shows here once found.
• due_at / deadline_at / overdue string | null / boolean · required — From when it is due (later after a no_answer), when it is overdue, and whether it is.
• owner object | null · required — Who does it: id and name.
• attempts / max_attempts integer · required — How many outcomes were logged, and after how many no_answer the task closes.
• outcome_note / completed_at string | null · required — The last note, and when it got its outcome.
• flow / flow_step / campaign_id / outreach_id / row_id string | null · required — Where it comes from: the flow and its step, the campaign, the sequence (outreach) and the row of the Leads table.
• outcomes object · required — What each outcome does: for a flow task, whether the sequence stops or continues.
• created_at / via string / string | null · required — When the task was created, and the key that created it (Claude), null for a task from a flow or a reply.
• next string — Only on a call that waits for a phone number: how to find it.
• dashboard_url string · required — The task on the Human tasks page.
• created boolean · required — False when external_id found the task you made before.

Credits#

Free. This call never uses credits.

Errors#

• 400 invalid_request — No kind or instruction, no person, a person named twice, a date or owner that is not valid, or an unknown field.
• 404 not_found — The person could not be found.
• 409 invalid_state — The key has no user behind it, so mySDR cannot record who did it.
• 401 authentication_error — The Authorization header is missing, or the key is unknown or revoked.
• 403 permission_error — API access is not part of your plan, or your account is suspended.
• 429 rate_limit_error — More than 60 requests per minute, or more than 3 at the same time, on one key. Wait for the Retry-After header.
• 503 service_unavailable — The API is temporarily unavailable. Retry later.
• 500 internal_error — Something went wrong on our side.

curl -X POST "https://mysdr.app/api/v1/human-tasks" \
  -H "Authorization: Bearer $MYSDR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "call",
    "instruction": "Call to ask whether the demo invite landed. Mention the funding round.",
    "reason": "Opened the proposal twice today",
    "id": "201"
  }'

{
  "object": "human_task",
  "id": "6f1c0f2e-4a1b-4d2e-9f6a-2b7c1d3e4f50",
  "source": "adhoc",
  "kind": "call",
  "instruction": "Call to ask whether the demo invite landed. Mention the funding round.",
  "reason": "No reaction after 3 days: step call_1 of flow cfo_after_funding.",
  "status": "open",
  "name": "Jane Example",
  "company": "Acme",
  "title": "CFO",
  "linkedin_url": "https://www.linkedin.com/in/jane-example",
  "email": null,
  "phone": "+32 470 12 34 56",
  "phone_needed": false,
  "due_at": "2026-10-29T09:00:00.000Z",
  "deadline_at": "2026-10-31T09:00:00.000Z",
  "overdue": false,
  "owner": {
    "id": "0b5a3c3e-1111-4c2e-9a3f-1234567890ab",
    "name": "Louis"
  },
  "attempts": 0,
  "max_attempts": 3,
  "outcome_note": null,
  "completed_at": null,
  "flow": null,
  "flow_step": null,
  "campaign_id": null,
  "outreach_id": null,
  "row_id": null,
  "created_at": "2026-10-29T09:00:00.000Z",
  "via": null,
  "outcomes": {
    "done_positive": "the flow stops",
    "done_negative": "the flow stops",
    "no_answer": "the task comes back in 2 days",
    "skip": "the flow continues"
  },
  "dashboard_url": "https://mysdr.app/en/gtm/human-tasks?task=6f1c0f2e-4a1b-4d2e-9f6a-2b7c1d3e4f50",
  "created": true
}