> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sendify.dingstore.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Start a campaign

> Create a recipient snapshot and start a standard bulk-email campaign

Validates a standard draft owned by the current user, creates a recipient snapshot from the current contacts and tags, and starts sending.

```http theme={null}
POST https://api.sendify.dingstore.cn/dmx/v2/campaigns/{id}/run
```

> [!WARNING]
>
> A successful response means that the campaign started. It does not mean that messages were delivered. Starting the same campaign again returns a state error.

## Authentication

```http theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Path parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `id` | `string` | Yes | Campaign ID returned by the create or list endpoint |

## Request body

Send an empty JSON object:

```json theme={null}
{}
```

## Request example

```bash theme={null}
curl -X POST \
  "https://api.sendify.dingstore.cn/dmx/v2/campaigns/03ec9355-4bf3-4a09-9829-4f3ef1d12a90/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Success response

Returns HTTP `200` with no business fields in the response body.

## Limitations

* Only standard draft campaigns owned by the current user are supported.
* Scheduled campaigns, pause/resume, and failed-run retries are not supported.
* Recipients are resolved from the latest contact and tag membership when the endpoint runs.
* A large recipient set may take longer to process.

## Error responses

| HTTP status | Meaning |
| - | - |
| `400` | Unsupported type or state, in-progress operation, no valid recipients, or inaccessible references |
| `401` | Missing or invalid Bearer API Key |
| `403` | The API Key lacks permission |
| `404` | Campaign not found or not owned by the current user |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.