REST API Request and Response Patterns/Simple create request body

POST a resource representation.

Section: JSON request patterns

Simple create request body

json
json
{
  "name": "Ava Martin",
  "email": "ava@example.com",
  "role": "admin"
}
Explanation

A clean top-level object is often enough for private APIs and straightforward CRUD designs.

Learn the surrounding workflow

Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.

Related commands

Same sheet · prioritizing JSON request patterns
Partial update body
PATCH with only the fields that change.
OpenIn sheetjsonsame section
Bulk create request
Submit multiple items in one call when needed.
OpenIn sheetjsonsame section
Sparse fieldsets
Return only requested fields.
OpenIn sheethttp1 tag match
Embed related resources on demand
Include relationships when the client asks for them.
OpenIn sheethttp1 tag match
Return an ETag for concurrency and caching
Tag a representation with a revision validator.
OpenIn sheethttp1 tag match
Protect updates with If-Match
Prevent lost updates from concurrent writes.
OpenIn sheethttp1 tag match