---
title: "Posts"
description: "Create a post to one or more accounts, get it by id, list your posts, and cancel a scheduled one."
section: "API reference"
url: https://dravo.dev/docs/api/posts
---
# Posts

The post is the core resource of Dravo. You create a post against one or more
connected accounts and Dravo delivers it asynchronously. The response returns the
post `id`; use it to get the post or cancel it while scheduled. For the model
behind these calls, read [async publishing](/docs/concepts/async-publishing).

## The post resource

A post fans out to one or more connected accounts. Each endpoint lives on its own
page:

- [Create a post](/docs/api/posts/create): `POST /v1/posts`
- [List posts](/docs/api/posts/list): `GET /v1/posts`
- [Get a post](/docs/api/posts/get): `GET /v1/posts/{id}`
- [Cancel a scheduled post](/docs/api/posts/cancel): `POST /v1/posts/{id}/cancel`

Per-platform publish options live in the create endpoint because they are part of
the `POST /v1/posts` request body. See [Create a post](/docs/api/posts/create#per-platform-options)
for every accepted `platform_options` key, examples, validation rules and
platform-specific behavior.
