---
name: "outreach_set_status"
area: "outreach"
title: "Mark someone interested or not"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/outreach_set_status"
mcp_server: "https://api.conecto.chat/mcp/outreach"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/outreach/outreach_set_status"
---

# Mark someone interested or not (`outreach_set_status`)

Keep in the CRM whether someone outreach reached is interested or not; their pending emails stop.

Keep in the CRM whether someone your outreach reached is interested or not interested (their contact's outreach_status), by contact_id or email. Their pending outreach emails stop either way; not interested also puts them on the do-not-email list, so no campaign writes to them again. Their lifecycle stage stays as it is: change it with crm_update_contact when the person moves on.

Price: Free. A call that fails costs nothing.

## Use it when

After someone answers, once you or the person know where they stand.

- For moving them along the customer lifecycle, use [crm_update_contact](https://conecto.chat/tools/crm/crm_update_contact.md).

## Say this to your agent

> Maya from the Alder Street Hotel wants the trial bikes. Mark her as interested.

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `status` | string | yes |  | `"interested"`, `"not_interested"` |  |
| `contact_id` | integer | no | At least 1. |  |  |
| `email` | string | no | Up to 254 characters. |  |  |

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `outreach_set_status` on the MCP server `https://api.conecto.chat/mcp/outreach` with these arguments:

```json
{
  "email": "maya@alderstreethotel.example",
  "status": "interested"
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/outreach_set_status \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "maya@alderstreethotel.example", "status": "interested"}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "outreach_set_status",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "contact": {
      "id": 4101,
      "email": "maya@alderstreethotel.example",
      "name": "Maya Brooks",
      "title": "",
      "company": "The Alder Street Hotel",
      "company_id": 4101,
      "phone": "",
      "location": "",
      "lifecycle_stage": "lead",
      "outreach_status": "interested",
      "notes": "",
      "tags": [
        "hotel"
      ],
      "custom_fields": {},
      "archived": false,
      "updated_at": "2026-10-14T08:00:00+00:00"
    },
    "follow_ups_stopped": 0
  }
}
```

`result`: contact (as crm_get_contact shows it, with outreach_status) and follow_ups_stopped.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `not_found` | 404 | No contact has that id or email. | Find them with crm_search. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [outreach_connect_mailbox](https://conecto.chat/tools/outreach/outreach_connect_mailbox.md): A one-hour link for the owner to connect their own mailbox for outreach, typing its password on a Conecto page. Free.
- [outreach_mailboxes](https://conecto.chat/tools/outreach/outreach_mailboxes.md): The business's mailboxes connected for outreach, each with its state, daily limit, what it sent today and its bounce rate; never a password. Free up to 1,000,000 reads a month.
- [outreach_update_mailbox](https://conecto.chat/tools/outreach/outreach_update_mailbox.md): Rename an outreach mailbox, change its daily limit, pause or resume its sending, or disconnect it. Free.
- [outreach_save_campaign](https://conecto.chat/tools/outreach/outreach_save_campaign.md): Create or change an outreach campaign: its mailboxes, the emails you write, the audience, a first line per person and when it sends. Free.
- [outreach_preview](https://conecto.chat/tools/outreach/outreach_preview.md): One step of an outreach campaign as it will go, for real people: to, from, the subject and the text with the unsubscribe line. Free up to 1,000,000 reads a month.
- [outreach_start](https://conecto.chat/tools/outreach/outreach_start.md): Start an outreach campaign the person approved; $0.01 per person when their first email leaves. Free.
- [outreach_campaigns](https://conecto.chat/tools/outreach/outreach_campaigns.md): The business's outreach campaigns, newest first, each with its status and numbers. Free up to 1,000,000 reads a month.
- [outreach_get_campaign](https://conecto.chat/tools/outreach/outreach_get_campaign.md): An outreach campaign with its numbers, each step's emails and replies, and its people page by page with their status. Free up to 1,000,000 reads a month.
- [outreach_replies](https://conecto.chat/tools/outreach/outreach_replies.md): The replies to the business's outreach campaigns, newest first, with who wrote, the text and their status now. Free up to 1,000,000 reads a month.
- [outreach_pause](https://conecto.chat/tools/outreach/outreach_pause.md): Pause a running outreach campaign; replies are still read and resuming carries on. Free.
- [outreach_resume](https://conecto.chat/tools/outreach/outreach_resume.md): Resume a paused outreach campaign once what paused it is fixed. Free.
- [outreach_stop](https://conecto.chat/tools/outreach/outreach_stop.md): End an outreach campaign for good; nobody it hasn't emailed is emailed or charged. Free.