---
title: "Quickstart: 1Post docs"
url: "https://get1post.com/docs/quickstart.md"
canonical_url: "https://get1post.com/docs/quickstart"
last_updated: "2026-10-26"
type: "how-to"
summary: "Create a key, find your account ids and send your first post with one request. A short path from sign-up to a scheduled post through the 1Post API."
related: ["https://get1post.com/docs/api-authentication.md", "https://get1post.com/docs/api-posts.md", "https://get1post.com/docs/api.md", "https://get1post.com/docs.md"]
---

# Quickstart: 1Post docs

Create a key, find your account ids and send your first post with one request. A short path from sign-up to a scheduled post through the 1Post API.

Make a key in the dashboard, list your connected accounts with GET /v1/accounts, then send POST /v1/posts with the account ids and your text. Without a time the post is saved and not sent; add schedule_at, publish_now or use_next_free_slot to send it. Every request is checked against each network's rules first.

## Before you start

- A workspace with at least one connected account. [Connect accounts](https://get1post.com/docs/connect-accounts.md) first if you have none.
- A key with write scope. Keys are made in the dashboard and begin with op_live_.
- A way to send HTTPS requests with a JSON body.

## Send the first post

1. Call GET /v1/accounts with your key as a bearer token and copy the id of an account.
2. Call POST /v1/posts with a body such as {"accounts":["<id>"],"text":"Doors open at nine."}. The reply holds the post and one destination per account.
3. Add "schedule_at":"2026-03-10T09:00:00Z" to schedule it, or "publish_now":true to send it now. A time without an offset is read as UTC.
4. Send an Idempotency-Key header so a retry can never create a second post.

> A key acts with the role of the member who made it. A contributor's key puts every post into review, whatever the request asks for.

## Questions

**Does the first request publish anything?**

Only if it carries schedule_at, publish_now or use_next_free_slot. Without one of them the post is saved and nothing is sent.

## Related

- [API authentication and keys: 1Post docs](https://get1post.com/docs/api-authentication.md)
- [Creating and changing posts with the API: 1Post docs](https://get1post.com/docs/api-posts.md)
- [1Post API reference: every route, key and role](https://get1post.com/docs/api.md)
- [1Post docs: composer, scheduling, API, webhooks, MCP](https://get1post.com/docs.md)