Create a member

curl --request POST \
  --url https://www.ruddr.io/api/workspace/members \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "email": "<string>",
  "sendInvite": true,
  "isActive": true,
  "isBillable": true,
  "loginEnabled": true,
  "employmentTypeId": "employee",
  "costMethodId": "hourly",
  "defaultRate": 123,
  "defaultRateCurrency": "USD",
  "activeStartDate": "2023-12-25",
  "activeEndDate": "2023-12-25",
  "timeOffAllowed": true,
  "timeOffApprovalMode": "auto",
  "receiveMissingTimeReminders": true,
  "unsubmittedTimesheetReminders": true,
  "timesheetCapacityPolicy": "unrestricted",
  "internalId": "<string>",
  "internalNotes": "<string>",
  "securityRoleId": "<string>",
  "jobTitleId": "<string>",
  "memberLevelId": "<string>",
  "disciplineId": "<string>",
  "practiceId": "<string>",
  "locationId": "<string>",
  "managerId": "<string>",
  "timeOffApproverId": "<string>",
  "holidayScheduleId": "<string>",
  "tagIds": [
    "<string>"
  ],
  "certificationIds": [
    "<string>"
  ],
  "skillIds": [
    "<string>"
  ],
  "allowedTimeOffTypes": "all",
  "timeOffTypeIds": [
    "<string>"
  ]
}
'

{
  "id": "d2e30834-2092-4d8b-aae8-1f58fa4594cb",
  "name": "Jane Smith",
  "email": "jane.smith@example.com",
  "isActive": true,
  "isBillable": true,
  "loginEnabled": true,
  "invitationStatusId": "not_invited",
  "employmentTypeId": "employee",
  "costMethodId": "fixed_hourly",
  "defaultRate": 150,
  "defaultRateCurrency": "USD",
  "activeStartDate": "2025-01-15",
  "activeEndDate": "2027-06-30",
  "timeOffAllowed": true,
  "allowedTimeOffTypes": "all",
  "timeOffApprovalMode": "auto",
  "receiveMissingTimeReminders": true,
  "unsubmittedTimesheetReminders": true,
  "timesheetCapacityPolicy": "unrestricted",
  "internalId": "EMP-001",
  "internalNotes": "Senior consultant with expertise in cloud architecture.",
  "createdAt": "2025-01-15T20:47:03.284Z",
  "trackTimeByDuration": true,
  "trackTimeByTimeRange": false,
  "jobTitle": {
    "id": "a1b2c3d4-e5f6-4789-ab01-234567890abc",
    "name": "Senior Consultant"
  },
  "level": {
    "id": "b2c3d4e5-f6a7-4890-bc12-345678901bcd",
    "name": "Senior"
  },
  "discipline": {
    "id": "c3d4e5f6-a7b8-4901-cd23-456789012cde",
    "name": "Engineering"
  },
  "practice": {
    "id": "d4e5f6a7-b8c9-4012-de34-567890123def",
    "name": "Consulting"
  },
  "location": {
    "id": "e5f6a7b8-c9d0-4123-ef45-678901234ef0",
    "name": "San Francisco"
  },
  "manager": {
    "id": "f6a7b8c9-d0e1-4234-f056-789012345f01",
    "name": "Robert Chen"
  },
  "timeOffApprover": {
    "id": "f6a7b8c9-d0e1-4234-f056-789012345f01",
    "name": "Robert Chen"
  },
  "holidaySchedule": {
    "id": "a7b8c9d0-e1f2-4345-0167-890123456a12",
    "name": "US Holidays"
  },
  "securityRole": {
    "id": "b8c9d0e1-f2a3-4456-1278-901234567b23",
    "name": "Member"
  },
  "tags": [
    {
      "id": "c9d0e1f2-a3b4-4567-2389-012345678c34",
      "name": "Billable"
    }
  ],
  "certifications": [
    {
      "id": "d0e1f2a3-b4c5-4678-34ab-123456789d45",
      "name": "AWS Certified Solutions Architect"
    }
  ],
  "skills": [
    {
      "id": "e1f2a3b4-c5d6-4789-45bc-234567890e56",
      "name": "Python"
    }
  ],
  "availabilityPeriods": [
    {
      "id": "f2a3b4c5-d6e7-4890-56cd-345678901f67",
      "start": "2025-01-15",
      "end": "2026-12-31",
      "hoursPerDay": [
        0,
        8,
        8,
        8,
        8,
        8,
        0
      ]
    }
  ],
  "timeOffTypes": [
    {
      "id": "a3b4c5d6-e7f8-4901-67de-456789012a78",
      "name": "Vacation"
    }
  ],
  "costPeriods": [
    {
      "id": "b4c5d6e7-f8a9-4012-78ef-567890123b89",
      "start": "2025-01-15",
      "end": "2026-12-31",
      "currency": "USD",
      "costPerHour": 100,
      "overheadCostPerHour": 20,
      "totalCostPerHour": 120,
      "currencyName": "US Dollar"
    }
  ],
  "utilizationTargetPeriods": [
    {
      "id": "c5d6e7f8-a9b0-4123-89f0-678901234c90",
      "start": "2025-01-15",
      "end": "2026-12-31",
      "targetPercentage": 80
    }
  ],
  "forbidTimesheetSubmissionWhenBelowCapacity": false
}

POST

members

Create a member

curl --request POST \
  --url https://www.ruddr.io/api/workspace/members \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "email": "<string>",
  "sendInvite": true,
  "isActive": true,
  "isBillable": true,
  "loginEnabled": true,
  "employmentTypeId": "employee",
  "costMethodId": "hourly",
  "defaultRate": 123,
  "defaultRateCurrency": "USD",
  "activeStartDate": "2023-12-25",
  "activeEndDate": "2023-12-25",
  "timeOffAllowed": true,
  "timeOffApprovalMode": "auto",
  "receiveMissingTimeReminders": true,
  "unsubmittedTimesheetReminders": true,
  "timesheetCapacityPolicy": "unrestricted",
  "internalId": "<string>",
  "internalNotes": "<string>",
  "securityRoleId": "<string>",
  "jobTitleId": "<string>",
  "memberLevelId": "<string>",
  "disciplineId": "<string>",
  "practiceId": "<string>",
  "locationId": "<string>",
  "managerId": "<string>",
  "timeOffApproverId": "<string>",
  "holidayScheduleId": "<string>",
  "tagIds": [
    "<string>"
  ],
  "certificationIds": [
    "<string>"
  ],
  "skillIds": [
    "<string>"
  ],
  "allowedTimeOffTypes": "all",
  "timeOffTypeIds": [
    "<string>"
  ]
}
'

{
  "id": "d2e30834-2092-4d8b-aae8-1f58fa4594cb",
  "name": "Jane Smith",
  "email": "jane.smith@example.com",
  "isActive": true,
  "isBillable": true,
  "loginEnabled": true,
  "invitationStatusId": "not_invited",
  "employmentTypeId": "employee",
  "costMethodId": "fixed_hourly",
  "defaultRate": 150,
  "defaultRateCurrency": "USD",
  "activeStartDate": "2025-01-15",
  "activeEndDate": "2027-06-30",
  "timeOffAllowed": true,
  "allowedTimeOffTypes": "all",
  "timeOffApprovalMode": "auto",
  "receiveMissingTimeReminders": true,
  "unsubmittedTimesheetReminders": true,
  "timesheetCapacityPolicy": "unrestricted",
  "internalId": "EMP-001",
  "internalNotes": "Senior consultant with expertise in cloud architecture.",
  "createdAt": "2025-01-15T20:47:03.284Z",
  "trackTimeByDuration": true,
  "trackTimeByTimeRange": false,
  "jobTitle": {
    "id": "a1b2c3d4-e5f6-4789-ab01-234567890abc",
    "name": "Senior Consultant"
  },
  "level": {
    "id": "b2c3d4e5-f6a7-4890-bc12-345678901bcd",
    "name": "Senior"
  },
  "discipline": {
    "id": "c3d4e5f6-a7b8-4901-cd23-456789012cde",
    "name": "Engineering"
  },
  "practice": {
    "id": "d4e5f6a7-b8c9-4012-de34-567890123def",
    "name": "Consulting"
  },
  "location": {
    "id": "e5f6a7b8-c9d0-4123-ef45-678901234ef0",
    "name": "San Francisco"
  },
  "manager": {
    "id": "f6a7b8c9-d0e1-4234-f056-789012345f01",
    "name": "Robert Chen"
  },
  "timeOffApprover": {
    "id": "f6a7b8c9-d0e1-4234-f056-789012345f01",
    "name": "Robert Chen"
  },
  "holidaySchedule": {
    "id": "a7b8c9d0-e1f2-4345-0167-890123456a12",
    "name": "US Holidays"
  },
  "securityRole": {
    "id": "b8c9d0e1-f2a3-4456-1278-901234567b23",
    "name": "Member"
  },
  "tags": [
    {
      "id": "c9d0e1f2-a3b4-4567-2389-012345678c34",
      "name": "Billable"
    }
  ],
  "certifications": [
    {
      "id": "d0e1f2a3-b4c5-4678-34ab-123456789d45",
      "name": "AWS Certified Solutions Architect"
    }
  ],
  "skills": [
    {
      "id": "e1f2a3b4-c5d6-4789-45bc-234567890e56",
      "name": "Python"
    }
  ],
  "availabilityPeriods": [
    {
      "id": "f2a3b4c5-d6e7-4890-56cd-345678901f67",
      "start": "2025-01-15",
      "end": "2026-12-31",
      "hoursPerDay": [
        0,
        8,
        8,
        8,
        8,
        8,
        0
      ]
    }
  ],
  "timeOffTypes": [
    {
      "id": "a3b4c5d6-e7f8-4901-67de-456789012a78",
      "name": "Vacation"
    }
  ],
  "costPeriods": [
    {
      "id": "b4c5d6e7-f8a9-4012-78ef-567890123b89",
      "start": "2025-01-15",
      "end": "2026-12-31",
      "currency": "USD",
      "costPerHour": 100,
      "overheadCostPerHour": 20,
      "totalCostPerHour": 120,
      "currencyName": "US Dollar"
    }
  ],
  "utilizationTargetPeriods": [
    {
      "id": "c5d6e7f8-a9b0-4123-89f0-678901234c90",
      "start": "2025-01-15",
      "end": "2026-12-31",
      "targetPercentage": 80
    }
  ],
  "forbidTimesheetSubmissionWhenBelowCapacity": false
}

A person that belongs to your workspace.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name

string

required

The name of the member. Max 255 chars.

string

required

The email address of the member. Must be unique between all members. Max 255 chars.

sendInvite

boolean

If set to true and the member is created successfully, an invitation will be sent to join the workspace. loginEnabled must be set to true. Defaults false if not provided.

isActive

boolean

Whether the member is active in the system.

isBillable

boolean

Whether the member is billable.

Whether the member can log into the workspace.

employmentTypeId

enum<string>

The type of employment for this member. Defaults to "employee" if not provided.

Available options:

employee,

contractor,

other

costMethodId

enum<string>

The cost method for the member.

Available options:

hourly,

fixed_hourly,

fixed_monthly

defaultRate

number<float>

The default bill rate for the member.

defaultRateCurrency

string

default:USD

The currency code for the default rate.

activeStartDate

string<date>

The active start date (YYYY-MM-DD) of the member. Must come on or before activeEndDate if set.

activeEndDate

string<date>

The active end date (YYYY-MM-DD) of the member. Must come on or after activeStartDate if set.

timeOffAllowed

boolean

Whether the member is allowed to create time-off time entries. Defaults true if not set.

timeOffApprovalMode

enum<string>

The approval mode for time-off time entries. Defaults to "auto" if not set. If set to "manager" then managerId is required. If set to "member" then timeOffApproverId is required.

Available options:

auto,

manager,

member

receiveMissingTimeReminders

boolean

Whether the member receives missing time reminders. Defaults true if not set.

unsubmittedTimesheetReminders

boolean

Whether the member receives reminders for unsubmitted timesheets. Defaults true if not set.

timesheetCapacityPolicy

enum<string>

The timesheet capacity policy. Possible values are: "unrestricted", "timesheet", or "week". Defaults to "unrestricted" if not provided.

Available options:

unrestricted,

timesheet,

week

internalId

string

An extra identifier field for tracking this member against other systems. Must be unique between all members. Max 255 chars.

internalNotes

string

An area to store extra notes about the member. Max 5000 chars.

securityRoleId

string

The ID (uuid) of the security role for this member. The default security role will be used if not set.

jobTitleId

string

The ID (uuid) of the job title for this member.

memberLevelId

string

The ID (uuid) of the member level for this member.

disciplineId

string

The ID (uuid) of the discipline for this member.

practiceId

string

The ID (uuid) of the practice for this member.

locationId

string

The ID (uuid) of the location for this member.

managerId

string

The member ID (uuid) of the manager for this member. Required if timeOffApprovalMode is "manager".

timeOffApproverId

string

The member ID (uuid) of the time off approver for this member. Required if timeOffApprovalMode is "member".

holidayScheduleId

string

The ID (uuid) of the holiday schedule for this member.

tagIds

string[]

A list of member tag IDs (uuid) associated with this member.

certificationIds

string[]

A list of member certification IDs (uuid) associated with this member.

skillIds

string[]

A list of member skill IDs (uuid) associated with this member.

allowedTimeOffTypes

enum<string>

The allowed time off types for time-off entries. Possible values are: "all" (All types are allowed) or "custom" (Only specific types are allowed). Defaults to "all" if not provided.

Available options:

all,

custom

timeOffTypeIds

string[]

A list of time off types IDs (uuid) associated with this member.

Response

200

string

The unique identifier for the object.

name

string

The name of the member.

string

The email address of the member.

isActive

boolean

Whether the member is active in the system.

isBillable

boolean

Whether the member is billable.

Whether the member can log into the workspace.

invitationStatusId

enum<string>

The invitation status of the member.

Available options:

not_invited,

invited,

accepted

employmentTypeId

enum<string>

The type of employment for this member.

Available options:

employee,

contractor,

other

costMethodId

enum<string>

Deprecated. The cost method for the member.

Available options:

hourly,

fixed_hourly,

fixed_monthly

defaultRate

number<float> | null

The default bill rate for the member.

defaultRateCurrency

string

default:USD

The currency code for the default rate.

activeStartDate

string<date> | null

The start date of the member's active period. Will be in the form YYYY-MM-DD.

activeEndDate

string<date> | null

The end date of the member's active period. Will be in the form YYYY-MM-DD.

timeOffAllowed

boolean

Whether the member is allowed to create time-off time entries.

allowedTimeOffTypes

enum<string>

The allowed time off types for time-off entries.

Available options:

all,

custom

timeOffApprovalMode

enum<string>

The approval mode for time-off time entries.

Available options:

auto,

manager,

member

receiveMissingTimeReminders

boolean

Whether the member receives missing time reminders.

unsubmittedTimesheetReminders

boolean

Whether the member receives reminders for unsubmitted timesheets.

timesheetCapacityPolicy

enum<string>

The timesheet capacity policy.

Available options:

unrestricted,

timesheet,

week

internalId

string | null

An identifier for tracking this member against other systems.

internalNotes

string | null

Extra notes about the member.

createdAt

string<date-time>

The timestamp when the object was created.

trackTimeByDuration

boolean

Whether the member can track time by entering a duration.

trackTimeByTimeRange

boolean

Whether the member can track time by entering a start and end time.

jobTitle

object

The job title assigned to the member.

Show child attributes

level

object

The member level assigned to the member.

Show child attributes

discipline

object

The discipline assigned to the member.

Show child attributes

practice

object

The practice assigned to the member.

Show child attributes

location

object

The location assigned to the member.

Show child attributes

manager

object

The member's direct manager.

Show child attributes

timeOffApprover

object

The member designated to approve time-off requests. Only populated when timeOffApprovalMode is "member".

Show child attributes

holidaySchedule

object

The holiday schedule assigned to the member.

Show child attributes

securityRole

object

The security role assigned to the member.

Show child attributes

Projects

Time

Pipeline

Expenses

Resourcing

Billing

Workspace

Members

Custom Data

Create a member

Authorizations

Body

Response