Built-in tool

Set a goal

Set or change a workspace goal: a target for a metric over a period, with the agent responsible.

Freeno per-call chargeNo API key needed

Endpoint

Parameters

NameTypeRequiredNote
namestring · optionalstringoptional

Short name, e.g. 'Connection requests per day'. Defaults to the metric and period.

Example: Connection requests per day

notestring · optionalstringoptional

Why this target, or who set it.

unitstring · optionalstringoptional

For a reported metric: its unit, e.g. 'calls', 'comments', 'USD'.

endsOnstring · optionalstringoptional

Last day, YYYY-MM-DD, e.g. the end of an 8-week test. Omit for an ongoing goal.

Example: the end of an 8-week test

goalIdstring · optionalstringoptional

Change this goal. Omit to set the goal for a metric and period (an existing active goal for the same metric, period and Workflow is updated).

metricstring · optionalstringoptional

What is counted. Measured by Connie: connection_requests_sent, connections_accepted, messages_sent, replies, positive_replies, accept_rate, reply_rate, positive_reply_rate, people_added, calls_booked, credits_spent (rates in percent). Any other name (e.g. 'post_comments', 'followers_gained') is a reported metric whose value you record with goal-report-progress.

periodstring · optionalstringoptional

Over what the target counts: 'day', 'week' (Monday to Sunday), 'month', 'quarter', or 'total' (from startsOn to endsOn).

One of: day, week, month, quarter, total

statusstring · optionalstringoptional

'archived' retires the goal (with goalId).

One of: active, archived

targetnumber · optionalnumberoptional

The number to reach, or the limit to stay under. Rates in percent (30 means 30%).

startsOnstring · optionalstringoptional

First day, YYYY-MM-DD. Default today.

timezonestring · optionalstringoptional

IANA time zone the days and weeks follow, e.g. 'Asia/Makassar'. Default UTC.

Example: Asia/Makassar

directionstring · optionalstringoptional

'at_least' (reach it) or 'at_most' (stay under it, e.g. a spend limit). Default at_least; at_most for credits_spent.

One of: at_least, at_most

workflowIdstring · optionalstringoptional

Count only this Workflow (campaign). Omit for the whole workspace.

ownerAgentIdstring · optionalstringoptional

Agent responsible for the goal. Defaults to the agent calling.

Get started

How to use this tool

  1. Connect your AI

    Add Connie to ChatGPT, Claude or Slack once, and this tool comes with it. There’s no API key or account to set up.

  2. Ask for the outcome

    Describe what you need in plain words. Your AI runs this tool when the job calls for it, along with any others it needs.

  3. Make it a workflow

    Add it as a step in a workflow that runs the same way every time, on a schedule or when something happens.

  4. Stay in control

    Choose whether it runs on its own or asks first. When it asks, you see an Allow or Deny card before any credits are spent.