Move a lead to another status
curl --request PATCH \
--url https://api.investorlift.com/marketplace/v1/sell/deals/{deal_id}/leads/{buyer_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.investorlift.com/marketplace/v1/sell/deals/{deal_id}/leads/{buyer_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/marketplace/v1/sell/deals/{deal_id}/leads/{buyer_id}"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"data": {
"deal_id": "<string>",
"buyer_id": "<string>",
"status": "new",
"origin": "acted",
"buyer": {
"buyer_id": "<string>",
"name": "<string>",
"entity_name": "<string>",
"email": "<string>",
"phone": "<string>",
"phone_type": "<string>"
},
"interactions": {
"viewed": true,
"favorited": true,
"inquired": true,
"requested_address": true,
"offered": true
},
"last_action_at": "2023-11-07T05:31:56Z",
"history": [
{
"status": "new",
"cause": "<string>",
"at": "2023-11-07T05:31:56Z"
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"meta": {
"request_id": "<string>",
"api_version": "<string>"
}
}{
"type": "https://developers.investorlift.com/marketplace/errors#invalid_body",
"title": "Body unusable",
"status": 400,
"code": "invalid_body",
"detail": "<string>",
"recovery": "Send a JSON body with the content type application/json.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#unauthorized",
"title": "Not authenticated",
"status": 401,
"code": "unauthorized",
"detail": "<string>",
"recovery": "Send a current access token for this API, and start a new authorization when the token is expired.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#designation_required",
"title": "Designation missing",
"status": 403,
"code": "designation_required",
"detail": "<string>",
"recovery": "Finish the onboarding of the side you call, then repeat the call.",
"request_id": "<string>",
"designation": "seller"
}{
"type": "https://developers.investorlift.com/marketplace/errors#not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "<string>",
"recovery": "Check the id, and check that the account you call with owns the resource.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#method_not_allowed",
"title": "Method not allowed",
"status": 405,
"code": "method_not_allowed",
"detail": "<string>",
"recovery": "Use one of the methods the documentation lists for this path.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#lead_locked",
"title": "Lead locked",
"status": 409,
"code": "lead_locked",
"detail": "<string>",
"recovery": "Read the lead to see its current status, because a closed lead takes no change.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#invalid_transition",
"title": "Transition not allowed",
"status": 422,
"code": "invalid_transition",
"detail": "<string>",
"recovery": "Read the resource, then pick a status the detail lists as a next step.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#origin_error",
"title": "Service unavailable",
"status": 503,
"code": "origin_error",
"detail": "<string>",
"recovery": "Repeat the call in a minute, and tell Investorlift support when the answer stays the same.",
"request_id": "<string>"
}Reference: sell
Move a lead to another status
Moves one lead to another status.
PATCH
/
sell
/
deals
/
{deal_id}
/
leads
/
{buyer_id}
Move a lead to another status
curl --request PATCH \
--url https://api.investorlift.com/marketplace/v1/sell/deals/{deal_id}/leads/{buyer_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.investorlift.com/marketplace/v1/sell/deals/{deal_id}/leads/{buyer_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.investorlift.com/marketplace/v1/sell/deals/{deal_id}/leads/{buyer_id}"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"data": {
"deal_id": "<string>",
"buyer_id": "<string>",
"status": "new",
"origin": "acted",
"buyer": {
"buyer_id": "<string>",
"name": "<string>",
"entity_name": "<string>",
"email": "<string>",
"phone": "<string>",
"phone_type": "<string>"
},
"interactions": {
"viewed": true,
"favorited": true,
"inquired": true,
"requested_address": true,
"offered": true
},
"last_action_at": "2023-11-07T05:31:56Z",
"history": [
{
"status": "new",
"cause": "<string>",
"at": "2023-11-07T05:31:56Z"
}
],
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"meta": {
"request_id": "<string>",
"api_version": "<string>"
}
}{
"type": "https://developers.investorlift.com/marketplace/errors#invalid_body",
"title": "Body unusable",
"status": 400,
"code": "invalid_body",
"detail": "<string>",
"recovery": "Send a JSON body with the content type application/json.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#unauthorized",
"title": "Not authenticated",
"status": 401,
"code": "unauthorized",
"detail": "<string>",
"recovery": "Send a current access token for this API, and start a new authorization when the token is expired.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#designation_required",
"title": "Designation missing",
"status": 403,
"code": "designation_required",
"detail": "<string>",
"recovery": "Finish the onboarding of the side you call, then repeat the call.",
"request_id": "<string>",
"designation": "seller"
}{
"type": "https://developers.investorlift.com/marketplace/errors#not_found",
"title": "Not found",
"status": 404,
"code": "not_found",
"detail": "<string>",
"recovery": "Check the id, and check that the account you call with owns the resource.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#method_not_allowed",
"title": "Method not allowed",
"status": 405,
"code": "method_not_allowed",
"detail": "<string>",
"recovery": "Use one of the methods the documentation lists for this path.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#lead_locked",
"title": "Lead locked",
"status": 409,
"code": "lead_locked",
"detail": "<string>",
"recovery": "Read the lead to see its current status, because a closed lead takes no change.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#invalid_transition",
"title": "Transition not allowed",
"status": 422,
"code": "invalid_transition",
"detail": "<string>",
"recovery": "Read the resource, then pick a status the detail lists as a next step.",
"request_id": "<string>"
}{
"type": "https://developers.investorlift.com/marketplace/errors#origin_error",
"title": "Service unavailable",
"status": 503,
"code": "origin_error",
"detail": "<string>",
"recovery": "Repeat the call in a minute, and tell Investorlift support when the answer stays the same.",
"request_id": "<string>"
}Authorizations
Authorization code with PKCE. The person grants the scopes on the Investorlift consent page and accepts the Marketplace API Terms there.
Path Parameters
The public id in the path, for example deal_id as mdl_a1b2c3d4e5f6.
The public id in the path, for example buyer_id as mdl_a1b2c3d4e5f6.
Body
application/json
The status the lead moves to.
Available options:
new, attempted_to_contact, not_interested, interested, offer_made Was this page helpful?