Execute a Salesforce Composite Graph API request to insert a hierarchy of related records atomically

In-depth guide

Steps

1. Design the graph: identify the root node (e.g., Account) and dependent nodes (e.g., Contact, Opportunity, OpportunityContactRole) that must reference each other
2. POST to /services/data/vXX.0/composite/graph with a body containing a graphs array; each graph object has a graphId string and a compositeRequest array of subrequest nodes
3. Assign a referenceId to each subrequest node; in subsequent nodes, use @{referenceId.id} syntax to forward the ID returned by an earlier node without a client-side round trip
4. Set allOrNone: true at the graph level to roll back all nodes in the graph if any single node fails — unlike the Composite API, Graph API commits or rolls back at the graph boundary
5. Include up to 500 subrequests across all graphs in a single POST, with up to 25 graphs per request; verify current limits in documentation as they may change
6. Parse the graphResponse array in the response: each element contains isSuccessful and a body matching standard sObject response format, with errors arrays for failures