How to Read the Meta Docs
How to navigate the Meta developer documentation — Guide vs Reference pages, how to read a parameters table, and where to find the API changelog.
On this page
The Meta developer documentation has two distinct page types — Guides and Reference pages — that serve completely different purposes. Knowing which one to open and how to read it prevents confusion and saves time.
The two page types#
Guides — developers.facebook.com/docs/whatsapp/cloud-api/guides/...
Step-by-step instructions that explain how to do something. Written for humans who are learning. Examples: "Send Messages", "Upload Media", "Set up webhooks". Use guides when you are learning a topic or following a setup flow.
Reference pages — developers.facebook.com/docs/whatsapp/cloud-api/reference/...
Complete technical listings of every endpoint, parameter, field, and error code. They do not explain why — they just document what exists. Use reference pages when you are building and need to know the exact field name, allowed values, or what is required vs optional.
How to read a Reference page#
Every reference page follows the same structure:
| Section | What it tells you |
|---|---|
| Method + endpoint | POST /{phone-number-id}/messages — the URL to call |
| Parameters table | Every field: name, type, required/optional, description |
| Sample request | A ready-to-copy example body |
| Sample response | What success looks like |
| Error codes | What can go wrong and what the code means |
The changelog — your most important bookmark#
developers.facebook.com/docs/graph-api/changelog
Meta releases new API versions several times a year. The changelog lists every version with what changed, what was added, and what was deprecated. Check the changelog when:
- You are upgrading from one API version to a newer one
- Something that was working suddenly breaks after a Meta update
- You want to know if a new feature is available in the latest version
See Request anatomy & versioning for how versions appear in the URL.
How to find anything fast#
- Start at
developers.facebook.com/docs/whatsapp— the main landing page with the full left-sidebar navigation. - Use the left sidebar to navigate between Guides and Reference sections.
- Use Ctrl+F inside a long reference page to jump to a specific field name.
- Use the search bar at the top of any page for cross-section searches.
Frequently asked#
What is the difference between a Guide and a Reference page?
A Guide is step-by-step instructions for how to do something — written for learning. A Reference page is a complete technical listing of every parameter and field — written for building. Use Guides to learn, use Reference pages to look up exact details while coding.
Where do I find the full list of fields I can send in a request?
In the Reference section:
developers.facebook.com/docs/whatsapp/cloud-api/reference/messages. The Parameters
table lists every field, whether it is required, its type, and what it does.
How do I know when Meta changes the API or adds new features?
Check the changelog at developers.facebook.com/docs/graph-api/changelog. It lists every
version release with what changed. Bookmark it and check it before upgrading your API
version number.
Where do I start when opening the Meta WhatsApp docs for the first time?
Go to developers.facebook.com/docs/whatsapp/cloud-api. The left sidebar shows all
sections — start with Guides for learning, then use Reference pages when you need exact
field details.
How do I find a specific field name on a long reference page?
Use Ctrl+F in your browser to search the page. Reference pages are long but well-structured — the field you need is always in the Parameters table.
Gotchas & common mistakes#
Was this page helpful?
Still stuck? Open a support ticket and our team will help.