Skip to navigation
Contact Request

Update a contact request's project status

View as Markdown

Moves a contact request in your directory to a new project status. projectStatus is required: new, contacted, engaged, on_hold, secured, launched_deployed or lost. Setting lost also requires lostReason; send lostReasonDetail (up to 500 characters) only when the reason is other. A closed request’s status can’t change. Each change sends a contact_request_updated webhook event.

Authentication

AuthorizationToken

Your API key, sent as Authorization: Token <your API key>

Path parameters

contactIdstringRequiredformat: "uuid"
ID of the contact request to update

Request

This endpoint expects an object.
projectStatusenumOptional
  • new - New
  • contacted - Contacted
  • engaged - Engaged
  • on_hold - On hold
  • secured - Secured
  • launched_deployed - Launched / Deployed
  • lost - Lost
lostReasonenum or nullOptional
  • customer_went_unresponsive - Customer went unresponsive
  • lost_to_another_provider - Lost to another provider
  • budget_or_timing - Budget or timing
  • not_a_fit_after_discovery - Not a fit after discovery
  • customer_handled_in_house - Customer handled in house
  • other - Other
lostReasonDetailstring or nullOptional<=500 characters

Response

Updated contact request
firstNamestring<=50 characters
lastNamestring<=50 characters
emailstringformat: "email"
companyNamestring<=255 characters
hrefstringRead-only
idstringformat: "uuid"
createdstringRead-only
statestring
projectStatusenum or null
  • new - New
  • contacted - Contacted
  • engaged - Engaged
  • on_hold - On hold
  • secured - Secured
  • launched_deployed - Launched / Deployed
  • lost - Lost
entrymap from strings to any
directorymap from strings to any
sourceenum
  • matchmaking - Matchmaking
  • contact_request - Contact Request
Allowed values:
matchOriginstring or nullformat: "uuid"
customFormstringRead-only
eventslist of objects
firstViewedAtdatetime or null
phonestring or nullOptional<=30 characters
companyWebsitestring or nullOptional<=255 characters
commentsstring or nullOptional<=1000 characters
utmQueryParamsanyOptional
customFormResponseIdstringOptionalformat: "uuid"
declineReasonstring or nullOptional
declineReasonDetailstring or nullOptional
closeReasonstring or nullOptional
closeReasonDetailstring or nullOptional
routingSourcestring or nullOptional
isStalebooleanOptional
daysWaitingintegerOptional>=0
reminderCountintegerOptional>=0
holdReasonenum or nullOptional
  • same_message - Same message already sent to 2 partners today
  • same_phone - Same phone number already sent to 2 partners today
  • same_company - Same company already sent to 2 partners today
Allowed values:
reminderobjectOptional
senderBlockedbooleanOptional
closeNotificationRecipientslist of stringsOptional
deliveryobjectOptional

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error