GuidesAPI ReferenceChangelogAPI StatusAPI PolicyGusto Security
API Reference

Create a people batch

post
https://api.gusto-demo.com/v1/companies//people_batches

Creates a batch for bulk employee creation.

The batch is processed asynchronously. Use the returned batch UUID to poll for status and results.

scope: people_batches:write

Path Params
string
required

The UUID of the company

Body Params
uuid
required

A unique identifier to ensure idempotency of the batch request

string
enum
required

The action to perform on the batch

Allowed:
batch
array of objects
required

Array of people to create

batch*
Headers
string
enum
Defaults to 2026-02-01

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Allowed:
Responses

Updated 6 days ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 6 days ago