apoc.create.nodes

Details
Syntax	`apoc.create.nodes(labels, props) :: (node)`
Description	Creates `NODE` values with the given dynamic labels.
Input arguments	Name	Type	Description
	`labels`	`LIST<STRING>`	The labels to assign to the new nodes.
	`props`	`LIST<MAP>`	The properties to assign to the new nodes.
Return arguments	Name	Type	Description
Return arguments	`node`	`NODE`	The created node.

Usage Examples

This procedure provides a more flexible way of creating nodes than Cypher’s CREATE clause.

The example below shows equivalent ways of creating a node with the Person and Actor labels, with a name property of "Tom Hanks":

apoc.create.node

CALL apoc.create.nodes(["Person", "Actor"], [{name: "Tom Hanks"}]);

CREATE clause

CREATE (node:Person:Actor {name: "Tom Hanks"})
RETURN node;

Results
node
(:Person:Actor {name: "Tom Hanks"})

But this procedure is mostly useful for creating nodes that have dynamic labels or properties. For example, we might want to create a node with labels or properties passed in as parameters.

The following creates labels and properties parameters:

:param labels =>  (["Human", "MovieStar"]);
:param properties => ([{name: "Tom Cruise", placeOfBirth: "Syracuse, New York, United States"}, {name: "Reese Witherspoon", placeOfBirth: "New Orleans, Louisiana, United States"}]);

The following creates nodes with labels and properties based on the previously defined parameters:

CALL apoc.create.nodes($labels, $properties);

Results
node
(:Human:MovieStar {name: "Tom Cruise", placeOfBirth: "Syracuse, New York, United States"})
(:Human:MovieStar {name: "Reese Witherspoon", placeOfBirth: "New Orleans, Louisiana, United States"})