HR

Send a policy to confirm

hr_send_policy · Changes data · Markdown

Emails each person in a policy's scope a one-time link to read and confirm its current version.

$0.02 per email sent

From your agent’s balance. A call that fails costs nothing.

An example

Send the AI use policy to everyone who hasn't confirmed it yet.

Your agent callshr_send_policy$0.02 per email sent

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "name": "ai-use-policy"
}
What comes back
{
  "policy": "ai-use-policy",
  "version": 1,
  "results": [
    {
      "person_id": 4103,
      "name": "Jonas Becker",
      "sent": true
    },
    {
      "person_id": 4102,
      "name": "Tom Okafor",
      "sent": true
    }
  ],
  "sent": 3
}

Use it when

A policy is new or changed and people must confirm it.

What it does

Email each person in the policy's scope (or just those named) a one-time link to read the current version and confirm it. People who confirmed it already, or have no work email, are skipped. Needs a paid account; at most 500 a day. $0.02 per email sent.

What comes back

policy and version; results: per person whether it was sent, and why not (no work email, confirmed already); sent: how many emails went. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
nameRequiredstringLike ai-use-policy. Matches ^[a-z0-9][a-z0-9-]{0,79}$.
peoplearray of integer or stringUp to 500 items.

The call

Over MCP, call hr_send_policy on https://api.conecto.chat/mcp/hr. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/hr_send_policy \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"ai-use-policy"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No policy has that name, or a person named in people is not on the HR records.Call hr_policy_status for the policies and hr_list_people for the people.
payment_required_for_outbound402The balance is still free credit.Top up once (POST /v1/topups).
rate_limited429The account sent 500 policy emails today.Send the rest tomorrow.

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md