Create a new opportunity

post

https://api.talentdesk.io/opportunities

Create a new opportunity. The opportunity's documents and file custom field answers should be ids of files uploaded via our /files/{fileName} endpoint

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

all_project_managers_can_manage_team

boolean | null

if any managers in the opportunity should be able to add/remove project members

brief

string

length ≥ 1

the opportunity brief

budget

number | null

the opportunity's budget, deducted from the specified owner's budget

clients

array of strings | null

array of client names

clients

custom_field_answers

object | null

an object of path and values for any available opportunity custom fields, which can be obtained from the /projects/custom-fields endpoint

deadline

string

/([0-9]{4})-([0-9]{2})-([0-9]{2})/

the deadline for the opportunity, may be required depending on the organization's settings

documents

array of numbers | null

an array of file ids, which were uploaded via /files/{fileName}

documents

external_project_id

string | null

an opportunity reference which could be used to reconcile with external systems

only_managers_can_view_project_team

boolean | null

if only managers should be allowed to view the opportunity's team

owner_id

number

the user id of the manager who will be the owner of the opportunity

started_at

string

/([0-9]{4})-([0-9]{2})-([0-9]{2})/

the start date for the opportunity

200Success

400BadRequestError

401Unauthorized