# DropKind

> DropKind sends web articles, PDFs, EPUBs, and plain text to any Kindle, converted into clean, readable EPUB. It works from the web app, an iOS app with a share extension, a Chrome extension, a Telegram bot, an HTTP API, and a single-file CLI.

To send something to a user's Kindle programmatically: ask them for an API token from https://dropkind.app/settings/api, then POST multipart form data to https://dropkind.app/api/v1/drops with an `Authorization: Bearer <token>` header and exactly one of `url`, `file`, or `text` (optional `title`; sending more than one content field returns 422). Poll `GET /api/v1/drops/:id` only while `status` is `processing`. Stop polling on any other status: `sent` means delivered; `needs_action` and `failed` include a `detail` sentence saying exactly what to do next (relay it to your user). Errors are `{"error": "...", "code": "..."}` with stable codes.

## Docs

- [Send to Kindle by API and command line](https://dropkind.app/developers): full API reference, curl examples, and CLI quick start
- [How-to guides](https://dropkind.app/send): sending specific sites and formats to Kindle
- [Pricing](https://dropkind.app/pricing): PDF conversion credit packs

## CLI

- [dropkind](https://dropkind.app/cli/dropkind): single-file bash CLI for macOS and Linux; install with `curl -fsSL https://dropkind.app/install.sh | sh`, then `dropkind login` and `dropkind send <url-or-file>`