# POST /scheduled-communications/:id/dispatch-now

**Resource:** [Scheduled Communications](./scheduled-communications.md)  
**Scopes:** `dispatcher:write`  
**Write operation:** yes

Flush a pending scheduled communication immediately. Sets scheduled_for to now and disables business-hours enforcement so the next scheduler tick (within 1 minute) picks it up. Only works on "pending" rows.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `id` | path | uuid | yes | Scheduled communication UUID to dispatch immediately |

## Request example

```bash
curl -X POST \
  "https://api.trustpager.com/functions/v1/api/v1/scheduled-communications/60b5889e-c8e1-4273-836e-67a3f0b3231a/dispatch-now" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response example

```json
{
  "data": {
    "id": "60b5889e-c8e1-4273-836e-67a3f0b3231a",
    "status": "pending",
    "scheduled_for": "2026-04-23T16:05:12.431Z",
    "respect_business_hours": false,
    "updated_at": "2026-04-23T16:05:12Z"
  },
  "meta": { "credits_remaining": 49998 }
}
```

## Notes

- Status remains "pending" until the scheduler tick claims it (within 1 minute).
- business-hours enforcement is disabled -- the scheduler dispatches regardless of the callee's local time.

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`