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=1 character

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>=0

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

Success

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.