DUduda
Native booking staff members api

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.

post/api/sites/multiscreen/{site_name}/booking/staff-members

Request

  • Base URL
    https://api.duda.co
  • URL
    https://api.duda.co/api/sites/multiscreen/{site_name}/booking/staff-members
  • Auth
    HTTP basic

Path parameters

site_namestring required

The site's unique name (its ID), returned when the site is created.

Request body

account_namestring nullable

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.

emailstring nullable

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.

namestring nullable

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.

timezonestring nullable

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.

Example request

{
  "account_name": "example-account",
  "email": "john.doe@multiscreensite.com",
  "name": "John Doe",
  "timezone": "America/New_York"
}

Response

OK

account_namestring nullable

Name of the Duda account associated with the staff member. For more information about accounts, see: https://developer.duda.co/reference/accounts-object. Null if the staff member is not associated with any account.

emailstring required

Email address of the staff member

idstring required

Unique identifier for the staff member

namestring required

Full name of the staff member

Example response

{
  "account_name": "example-account",
  "email": "john.doe@multiscreensite.com",
  "id": "staff-member-123",
  "name": "John Doe"
}

Changes

No recorded changes to this operation across all 1 revision of this API.