---
title: network.adminRunOutreach | Doing Work API
description: Doing Work staff: run one outreach pass now (the job also runs on its own). Sources shops for requests waiting near them, reads their own websites for a pu
url: https://doingwork.work/docs/reference/network-adminrunoutreach/
---

# network.adminRunOutreach

Doing Work staff: run one outreach pass now (the job also runs on its own). Sources shops for requests waiting near them, reads their own websites for a public email or a plain contact form (no captcha, no booking widget, robots.txt allowed), then emails them, or fills the form when DW_OUTREACH_FORMS is on. Up to the daily cap (default 25) across email and forms, once per shop per request and at most once per shop every 14 days, never to an address or site that opted out. Each message links to a page where the shop can quote with no account; the link works for 48 hours (DW_OUTREACH_CLAIM_HOURS). Sending pauses on its own when the 7-day bounce rate reaches 2% or the complaint rate 0.1%. Off unless DW_NETWORK_OUTREACH is on.

|  |  |
|---|---|
| Who | A person's own sign-in only (agent tokens are refused) |
| REST | `POST /v1/network/admin/run-outreach` |
| MCP tool | Not an MCP tool |
| Writes | yes, send an Idempotency-Key |
| Area | [Shop](https://doingwork.work/docs/reference/#shop) |

## When to use it

Requests and quotes are free for shops and customers. We will never charge lead or referral fees.

## What to tell the owner

Ask the person to do this with their own sign-in. Your agent token is refused here.

## Input

| Field | Type | Required |
|---|---|---|
| (none) |  |  |

## Example

```http
POST https://doingwork.work/v1/network/admin/run-outreach
content-type: application/json
Idempotency-Key: 3f1c...

{}
```

## Output

JSON. The response shape isn't published yet; read the fields you need and ignore the rest. Errors are `{code, message, status}`.

## Errors

| Code | Status | What to do |
|---|---|---|
| `invalid_input`, `invalid_token`, `rate_limited` |  | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |