Create staff member

Adds a staff member to the site, either by linking an existing Duda account with account_name - in which case email and name are resolved from that account - or by supplying email and name directly. The new staff member starts with a default weekly schedule in the requested timezone, which can then be changed through the availability endpoints. Returns 400 when the site is already at the staff member limit its plan allows, or when the account does not exist or already belongs to another staff member of this site; see StaffMemberErrorCode for the exact codes.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params
string | null

Name of a Duda account that will be associated with the staff member. For more information about accounts, see: https://developer.duda.co/reference/accounts-object. If provided, the account must exist and not be already associated with another staff member in this organization. When accountName is provided, email and name become optional and will be resolved from the account if not specified. If accountName is not provided, both email and name are required.

string | null

Email address of the staff member. Required if accountName is not provided. Optional if accountName is provided - if omitted, email will be resolved from the account. If provided when accountName is also specified, this value overrides the email associated with the account. Must be a valid email address format if provided.

string | null

Full name of the staff member. Required if accountName is not provided. Optional if accountName is provided - if omitted, name will be resolved from the account (firstName + lastName, or account name). If provided when accountName is also specified, this value overrides the name associated with the account. Cannot be empty or blank if provided.

string | null
Defaults to America/New_York

Timezone of the staff member for scheduling (e.g., 'America/New_York', 'Europe/London', 'UTC'). If not provided, defaults to 'America/New_York'. Used to initialize default schedule and availability settings.

Responses

401

Unauthorized request - missing or invalid credentials

429

Rate limit exceeded - please refer to api documentation for limits

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