Slotflow APIHumans

Create a human

Create a new human in your organization. Humans represent the real people whose time can be booked by AI agents.

The number of humans you can create depends on your plan (Free: 1, Starter: 5, Growth: 25).

Authentication

AuthorizationBearer
API key authentication. Pass your key as a Bearer token: ``` Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx ``` Get your API key from the [Slotflow Dashboard](https://app.slotflow.dev).

Request

This endpoint expects an object.
namestringRequired
Full name of the human
timezonestringRequired

IANA timezone identifier (e.g. “America/New_York”, “Europe/London”)

emailstringOptional

Email address (optional)

rolestringOptional

Role or title (optional, e.g. “sales_rep”, “interviewer”)

Response

Human created successfully
idstringformat: "uuid"
Unique identifier for the human
namestring
Full name of the human
timezonestring

IANA timezone identifier (e.g. “America/New_York”)

activeboolean
Whether the human is active and bookable
created_atdatetime
ISO 8601 creation timestamp
emailstring or null

Email address (optional)

rolestring or null

Role or title (e.g. “sales_rep”, “interviewer”)

Errors