The NextZen CSV Integration API provides endpoints that allow importing CSV data for each entity that can be imported.

Import endpoints accept a CSV body in sparse matrix format, containing rows representing the entities to be imported.

Leaving the id column blank and assigning a unique slug s will allow for grouping related rows by slug . The import process will auto-assign unique id s and return them in the response. For example to import organization profiles:

Import endpoints will echo the CSV request body, adding disposition and errors columns. All the grouped rows of each identity will have the sample disposition , which will be one of [invalid , failed , imported ].

When disposition is invalid , the errors column will contain specific validation errors, which can be corrected and then re-imported. The disposition and errors columns can be included in a CSV import body and will be ignored.

When disposition is failed , the import input is valid, but another error occurred. Examples might include a duplicate entitiy or a non-existent id reference.

Successfully imported entities will have disposition is imported .

The following import request show mixed disposition s and error s:

---