Create Resource

POST

Create a new Resource within your Workspace.

A Resource represents a person, material, or tool that is used within your Projects. When you attach a Resources to more than one Task, the software will schedule the usage of your Resource so that it is not allocated to more than one Task at the same time. The users in your Workspace are also considered Resources. To invite a new User to your Workspace, create a new Resource for that user.

Headers

x-integration-namestringOptional
The name of the calling system passed along as a header parameter

Request

This endpoint expects an object.
firstNamestringRequired

The first name of the person Resource.

Applies to personnel Resources only.

lastNamestringOptional

The last name of the person Resource.

Applies to personnel Resources only.

emailstringOptional
The email address of this Resource.
hourlyRatedoubleOptional
The basic hourly rate for this Resource.
phonestringOptional
The phone number associated with this Resource.
citystringOptional
The city where this Resource is located.
statestringOptional
The state or region where this Resource is located. This value is not constrained to a list of known states or regions.
countryCodestringOptional
A text field indicating the country in which this Resource is located. This value must be one of the following: US, NZ, AU.
notesstringOptional
Free-form text notes about this Resource. You may use this field to store extra information about the Resource.
roleIdstringOptional

The Role Id associated with this Resource.

Applies to personnel Resources only.

teamIdslist of stringsOptional
The list of ResourceTeams to which this Resource belongs.
skillIdslist of stringsOptional
The list of ResourceSkills possessed by this Resource.
colorNamestringOptional

Collaboration Color for this resource.

eg. teal, cyan, lightblue, blurple, purple, pink, orange, gray

countrystringOptionalDeprecated

Deprecated - this property is no longer being used. Please pass in Country data on the CountryCode property.

A text field indicating the country in which this Resource is located. This value is not constrained to the list of known ISO 3166 country names or codes.

rolestringOptionalDeprecated

Deprecated - this property is no longer being used. Please pass in Role data on the RoleId property

The Role privileges associated with this Resource.

Applies to personnel Resources only.

teamslist of stringsOptionalDeprecated

Deprecated - this property is no longer being used. Please pass in Team data on the TeamIds property

The list of ResourceTeams to which this Resource belongs.

skillslist of stringsOptionalDeprecated

Deprecated - this property is no longer being used. Please pass in Skill data on the SkillIds property

The list of ResourceSkills possessed by this Resource.

Response

This endpoint returns an object
errorobjectOptional
If the API call failed, this will contain information about the error that occurred.
successbooleanOptional
True if the API call succeeded; false otherwise.
hasErrorbooleanOptional
True if the API call failed.
statusCodeenumOptional
The HTTP code of the response.
dataobjectOptional
A Resource represents a person, material, or tool that is used within your Projects. When you attach a Resources to more than one Task, the software will schedule the usage of your Resource so that it is not allocated to more than one Task at the same time. The users in your Workspace are also considered Resources. To invite a new User to your Workspace, create a new Resource for that user.