---
search:
  tags:
    - Dispensing
    - POST
seo:
  description: >-
    Any signed in user. Files a refill reminder for the caller's branch and…
    Reference for the POST /api/v1/dispensing/refills endpoint in the PharmaFlow
    API.
sidebar:
  label: Create a refill reminder
  badge: POST
title: Create a refill reminder
type: openapi-operation
---
Any signed in user. Files a refill reminder for the caller's branch and returns the row. A missing medicine or due date is refused, and the reminder starts pending on sms by default.

`POST /api/v1/dispensing/refills`

**Request body** (`application/json`, required)

- `medicine_id` (string, required)
- `due_date` (string, required)
- `branch_id` (string)
- `customer_id` (string | null)
- `channel` (string)
- `notes` (string)

Request body example:

```json
{
  "medicine_id": "string",
  "due_date": "string",
  "branch_id": "string",
  "customer_id": "string",
  "channel": "string",
  "notes": "string"
}
```

**Responses**

- `201` — Reminder filed
- `400` — medicine\_id and due\_date are required
- `401` — Not authenticated

Response example, 201:

```json
{
  "id": "string",
  "branch_id": "string",
  "customer_id": "string",
  "medicine_id": "string",
  "due_date": "string",
  "channel": "string",
  "status": "string",
  "notes": "string",
  "created_at": "string",
  "medicine_name": "string"
}
```