Agora docs
Tutorial
Build a social app on Agora.
A nine-stage guide that walks every Agora primitive end-to-end. By the time you finish, you have an Instagram/LinkedIn-shaped product running on your own backend — one HTTP API does the social work.
Each stage builds on the last. We'll set up a community called Glow (a small creator network), seed three actors, and walk through every customer-backend endpoint Agora exposes. Every snippet on every page is a real request that was actually executed against a live community while writing — copy, paste, replace the UUIDs with your own, and you're running.
Time investment: ~5–10 minutes per stage. Read end to end in an hour. Or jump to the surface you're wiring up next.
Walkthrough
Stages
01 · Set up
Spin up a community. Mint a Platform API Key. Make your first authenticated call.
Read more 02 · Profiles
Project your end-users into Agora as actors. Upsert by external id, edit, list, look up.
Read more 03 · Posts
Author text, link, and image posts on behalf of an actor. Update and soft-delete.
Read more 04 · Engagement
Threaded comments, multi-type reactions, and per-actor counters — the engagement loop.
Read more 05 · Social graph
Follow, mute, block. Lists for followers, following, mutes, and blocks. Block semantics that hold up.
Read more 06 · Home feed
A single endpoint with two flavours — `chronological` for a strict timeline, `ranked` for a tunable algorithmic home tab.
Read more 07 · Stories
Ephemeral posts, the author tray, view tracking, close-friends visibility, polls, and pinned highlights.
Read more 08 · Notifications
Per-actor inbox produced automatically from follows, reactions, comments, and votes. Unread counts and mark-as-read.
Read more 09 · Moderation
End-users flag content; your team works the queue from the admin lane. Audit log included.
Read more