Tools

Who you are, your role, saved link, plan, and remaining quota. The assistant should call this first — everything else depends on it.

Input

None.

Returns

email, name, role, link, default_link_name, links[], link_saved, link_required, plan, subscribed_at, subscription_ends_at, total_sent, free_remaining, sent_last_24h, daily_limit, remaining_today, setup_needed

Example

{
  "email": "you@gmail.com",
  "name": "Himanshu Yadav",
  "role": "job_seeker",
  "role_label": "Job seeker",
  "link": "https://drive.google.com/file/d/…",
  "link_label": "Resume",
  "link_saved": true,
  "link_required": true,
  "plan": "free",
  "total_sent": 3,
  "free_email_limit": 5,
  "free_remaining": 2,
  "sent_last_24h": 3,
  "daily_limit": 80,
  "remaining_today": 77,
  "setup_needed": null
}

Sets what the user does — job_seeker, recruiter, or professional. The role decides what link rides along with their emails and whether one is required at all. Ask the user; never infer it. Changeable any time.

Input

Returns

success, role, role_label, link_label, link_required, next_step

Example

{
  "success": true,
  "role": "recruiter",
  "role_label": "Recruiter",
  "link_label": "Job description",
  "link_required": false,
  "next_step": "Optional: ask if they want a job description
   link on their emails."
}

Saves a URL the server can attach to emails. What it is depends on the role — a resume for a job seeker, a job description for a recruiter, a portfolio for a professional. Save as many named links as you like and mark one default. Give each a description of what it emphasises, and the assistant can match the right one to a job description instead of guessing from the name.

Input

Returns

success, name, link, is_default, default_link_name, links[], link_label, detail — or an error explaining the rejection

Example

{
  "success": true,
  "name": "backend",
  "link": "https://drive.google.com/file/d/…",
  "is_default": false,
  "default_link_name": "default"
}

Lists every saved link with its description and marks which is default. Called before sending when several resumes exist, so the assistant can read each description against the job description and pick the closest — or ask you when none clearly fits.

Input

None.

Returns

default_link_name, default_link, links[]

Example

{
  "default_link_name": "default",
  "default_link": "https://drive.google.com/file/d/…",
  "links": [
    { "name": "backend", "url": "https://resume.example/backend.pdf",
      "description": "Backend: Postgres, Go, queues", "is_default": true },
    { "name": "frontend", "url": "https://resume.example/frontend.pdf",
      "description": "Frontend: React, design systems", "is_default": false }
  ]
}

Changes which saved link is attached by default on future sends.

Input

Returns

success, default_link_name, link, links[]

Example

{
  "success": true,
  "default_link_name": "backend",
  "link": "https://resume.example/backend.pdf"
}

Deletes one saved link by name. If it was the default, Setu promotes another saved link or clears the default.

Input

Returns

success, deleted, default_link_name, link, links[]

Example

{
  "success": true,
  "deleted": "design",
  "default_link_name": "backend"
}

Advisory. Checks whether an address's domain can actually receive mail, and flags addresses that look constructed from a naming pattern rather than found on a page. Does not block sending unless VERIFY_HR_EMAILS is enabled on the server.

Input

Returns

checked, usable, rejected, results[] with reasons and warnings

Example

{
  "checked": 2,
  "usable": 1,
  "rejected": 1,
  "results": [
    { "email": "careers@acme.com", "ok": true,
      "detail": "MX: aspmx.l.google.com" },
    { "email": "hr@acme-inc.io", "ok": false,
      "reasons": ["acme-inc.io: domain does not exist"] }
  ]
}

Sends one email from your Gmail — any email, not only applications: meeting requests, follow-ups, greetings. Irreversible. Refuses if no role is set, if the role needs a link and none is saved, if the free allowance is spent, or if the daily limit is reached. Your link is appended by default; include_link=false leaves it off.

Input

Returns

success, to, subject, message_id, link_name, track_id — or success:false with error

Example

{
  "success": true,
  "to": "careers@acme.com",
  "subject": "Application for Backend Engineer at Acme",
  "message_id": "18f2a9c4d5e6b7a8"
}

Sends a batch of emails — applications or any other kind — pausing between each so Gmail doesn't read the run as automated. Capped at 25 per call, so you review as you go instead of finding out afterwards.

Input

Returns

sent, failed, skipped, skipped_details[], results[], remaining_today

Example

{
  "success": true,
  "sent": 8,
  "failed": 0,
  "skipped": 1,
  "skipped_details": [
    { "to": "hr@x.com", "reason": "daily limit reached" }
  ],
  "remaining_today": 60
}

Your numbers at a glance — lifetime and last-24h sends, companies reached, failures, remaining quota, plan, and the last few sends. The assistant calls this when you ask "how many emails have I sent?" or "show my stats".

Input

None.

Returns

email, name, plan, total_sent, total_failed, total_opens, opened_sends, companies_reached, sent_last_24h, daily_limit, remaining_today, free_remaining, subscription_ends_at, recent[5]

Example

{
  "plan": "free",
  "total_sent": 12,
  "total_failed": 1,
  "companies_reached": 9,
  "sent_last_24h": 3,
  "daily_limit": 80,
  "remaining_today": 77,
  "free_remaining": 0,
  "recent": [
    { "to_email": "careers@acme.com", "company": "Acme",
      "success": true, "sent_at": "2026-07-19T09:22:04+00:00" }
  ]
}

Who has been opening the links you sent, and what to do about it. Reads the open count together with how recently it happened and how long ago the mail went out, then orders the list so the ones worth acting on come first. hot = opened several times, someone came back or forwarded it. warm = opened in the last couple of days. cold = sent days ago and never opened, which is usually a wrong address or a spam folder rather than disinterest.

Input

Returns

counts, needs_attention[], all[], note

Example

{
  "counts": { "hot": 1, "warm": 1, "cold": 1 },
  "needs_attention": [
    {
      "company": "Acme Corp",
      "signal": "hot",
      "headline": "Acme Corp opened your link 4 times",
      "action": "Strong interest — following up now is well timed.",
      "open_count": 4
    }
  ],
  "note": "An open means the tracked link was fetched. It is a
   signal, not proof that the recipient read the email."
}

Everything you've sent through Setu, newest first. The record survives across sessions, which is what makes duplicate-send prevention possible.

Input

Returns

sent_last_24h, daily_limit, entries[]

Example

{
  "sent_last_24h": 12,
  "daily_limit": 80,
  "entries": [
    { "to_email": "careers@acme.com", "company": "Acme",
      "success": true, "message_id": "18f2a9c4d5e6b7a8",
      "sent_at": "2026-07-15T09:22:04+00:00" }
  ]
}