Unassign a lead Run in API Explorer
Ask AI
Clears the assignee. Requires leads:updateAll. A no-op when the lead is unassigned.
DELETE
/api/v1/leads/{lead_uuid}/assign
curl \
--request DELETE 'https://api.plannrcrm.com/api/v1/leads/53f22fe4-3731-4cdc-aa12-e65bd0b15e52/assign' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}"
Response examples (200)
{
"uuid": "0a4924fe-a6fc-4638-9b53-8e6c515bd913",
"title": "mr",
"first_name": "Sam",
"last_name": "Patel",
"name": "Sam Patel",
"client_type": "individual",
"date_of_birth": "1985-04-12",
"status": "new",
"status_changed_at": "2026-11-18T20:11:43+00:00",
"is_archived": false,
"is_disqualified": false,
"is_pending_disqualified": false,
"is_promoted": false,
"can_promote": true,
"can_update": true,
"can_archive": true,
"can_disqualify": "no",
"can_assign": false,
"can_update_introducer": false,
"can_view_promoted": false,
"source": {
"uuid": "05879ccb-e03f-4f4b-bc34-f0395a21dd32",
"name": "Website",
"description": "Enquiries via the contact page",
"position": 1,
"archived": false,
"sub_sources": {
"uuid": "2e77cfbb-3318-4892-9d33-c9540ece3315",
"name": "Google",
"description": "Paid search on Google",
"position": 1,
"archived": false,
"created_at": "2026-11-18T20:11:50+00:00",
"updated_at": "2026-11-18T20:11:50+00:00"
},
"created_at": "2026-11-18T20:11:43+00:00",
"updated_at": "2026-11-18T20:11:43+00:00"
},
"sub_source": {
"uuid": "e115585a-0df7-41bd-8ecd-52ab4dee0410",
"name": "Google",
"description": "Paid search on Google",
"position": 1,
"archived": false,
"lead_source": {
"uuid": "6cbe8899-5b2c-45f2-9ec7-0da21fa9ce4a",
"name": "Website",
"description": "Enquiries via the contact page",
"position": 1,
"archived": false,
"created_at": "2026-11-18T20:11:50+00:00",
"updated_at": "2026-11-18T20:11:50+00:00"
},
"created_at": "2026-11-18T20:11:43+00:00",
"updated_at": "2026-11-18T20:11:43+00:00"
},
"assigned_account": {
"uuid": "8dd966ef-7b4d-4374-9b2c-6d9394a737d5",
"created_at": "2026-11-18T20:11:43+00:00",
"updated_at": "2026-11-18T20:11:43+00:00",
"type": "client",
"role": "client",
"first_name": "Gareth",
"last_name": "Thompson",
"name": "Gareth Thompson",
"email": "gareth@codepotato.co.uk",
"photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
"external_references": {
"uuid": "4bcc9b2d-d5f4-4ea4-9e39-edbdbc538591",
"created_at": "2026-11-18T20:11:49+00:00",
"updated_at": "2026-11-18T20:11:49+00:00",
"third_party": "nucleus",
"reference": "AB123456"
}
},
"introduced_by": {
"uuid": "4ec3800e-bd94-49aa-a985-c2e18a0ed3e4",
"created_at": "2026-11-18T20:11:43+00:00",
"updated_at": "2026-11-18T20:11:43+00:00",
"type": "client",
"role": "client",
"first_name": "Gareth",
"last_name": "Thompson",
"name": "Gareth Thompson",
"email": "gareth@codepotato.co.uk",
"photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
"external_references": {
"uuid": "4bcc9b2d-d5f4-4ea4-9e39-edbdbc538591",
"created_at": "2026-11-18T20:11:49+00:00",
"updated_at": "2026-11-18T20:11:49+00:00",
"third_party": "nucleus",
"reference": "AB123456"
}
},
"created_by": {
"uuid": "de7a2120-5483-48ce-b965-32ff71090107",
"created_at": "2026-11-18T20:11:43+00:00",
"updated_at": "2026-11-18T20:11:43+00:00",
"type": "client",
"role": "client",
"first_name": "Gareth",
"last_name": "Thompson",
"name": "Gareth Thompson",
"email": "gareth@codepotato.co.uk",
"photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
"external_references": {
"uuid": "4bcc9b2d-d5f4-4ea4-9e39-edbdbc538591",
"created_at": "2026-11-18T20:11:49+00:00",
"updated_at": "2026-11-18T20:11:49+00:00",
"third_party": "nucleus",
"reference": "AB123456"
}
},
"archived_by": {
"uuid": "2ca9a597-35e3-48ee-97d4-523262f58a5e",
"created_at": "2026-11-18T20:11:43+00:00",
"updated_at": "2026-11-18T20:11:43+00:00",
"type": "client",
"role": "client",
"first_name": "Gareth",
"last_name": "Thompson",
"name": "Gareth Thompson",
"email": "gareth@codepotato.co.uk",
"photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
"external_references": {
"uuid": "4bcc9b2d-d5f4-4ea4-9e39-edbdbc538591",
"created_at": "2026-11-18T20:11:49+00:00",
"updated_at": "2026-11-18T20:11:49+00:00",
"third_party": "nucleus",
"reference": "AB123456"
}
},
"disqualified_by": {
"uuid": "544a063b-5e01-4d47-90c8-036e0250b8ad",
"created_at": "2026-11-18T20:11:43+00:00",
"updated_at": "2026-11-18T20:11:43+00:00",
"type": "client",
"role": "client",
"first_name": "Gareth",
"last_name": "Thompson",
"name": "Gareth Thompson",
"email": "gareth@codepotato.co.uk",
"photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
"external_references": {
"uuid": "4bcc9b2d-d5f4-4ea4-9e39-edbdbc538591",
"created_at": "2026-11-18T20:11:49+00:00",
"updated_at": "2026-11-18T20:11:49+00:00",
"third_party": "nucleus",
"reference": "AB123456"
}
},
"promoted_by": {
"uuid": "b9b06239-984d-4097-895d-a29d1d81c7b2",
"created_at": "2026-11-18T20:11:43+00:00",
"updated_at": "2026-11-18T20:11:43+00:00",
"type": "client",
"role": "client",
"first_name": "Gareth",
"last_name": "Thompson",
"name": "Gareth Thompson",
"email": "gareth@codepotato.co.uk",
"photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
"external_references": {
"uuid": "4bcc9b2d-d5f4-4ea4-9e39-edbdbc538591",
"created_at": "2026-11-18T20:11:49+00:00",
"updated_at": "2026-11-18T20:11:49+00:00",
"third_party": "nucleus",
"reference": "AB123456"
}
},
"client_account": {
"uuid": "80784471-f528-463b-ad71-96bb7f5704b8",
"created_at": "2026-11-18T20:11:43+00:00",
"updated_at": "2026-11-18T20:11:43+00:00",
"type": "client",
"role": "client",
"first_name": "Gareth",
"last_name": "Thompson",
"name": "Gareth Thompson",
"email": "gareth@codepotato.co.uk",
"photo_url": "https://eu.ui-avatars.com/api/?name=Gareth+Thompson",
"external_references": {
"uuid": "4bcc9b2d-d5f4-4ea4-9e39-edbdbc538591",
"created_at": "2026-11-18T20:11:49+00:00",
"updated_at": "2026-11-18T20:11:49+00:00",
"third_party": "nucleus",
"reference": "AB123456"
}
},
"primary_email": {
"uuid": "90dbff69-4391-4f39-9d2f-7b3bc557f4ce",
"created_at": "2026-11-18T20:11:43+00:00",
"updated_at": "2026-11-18T20:11:43+00:00",
"type": "phone_number",
"name": "Work number",
"value": "+443330903630",
"phone_number_meta": {
"country": "GB",
"formatted": "0333 090 3630"
},
"accounts": {
"uuid": "f08f3e8d-23bf-4d4b-b848-af98efb282eb",
"created_at": "2026-11-18T20:11:49+00:00",
"updated_at": "2026-11-18T20:11:49+00:00",
"type": "client",
"role": "client",
"first_name": "Gareth",
"last_name": "Thompson",
"name": "Gareth Thompson",
"email": "gareth@codepotato.co.uk",
"photo_url": "https://eu.ui-avatars.com/api/?name=gareth+thompson",
"first_contact_date": "2026-11-18T20:11:49+00:00",
"next_review_date": "2026-11-18T20:11:49+00:00",
"previous_review_date": "2026-11-18T20:11:49+00:00",
"anniversary_review_date": "2026-11-18T20:11:49+00:00",
"terms_of_business_at": "2026-11-18T20:11:49+00:00",
"client_agreement_at": "2026-11-18T20:11:49+00:00",
"with_login": true,
"has_joint_account": true,
"can_be_deleted": "false",
"ownership_percentage": 100.0,
"inactive_at": "2026-11-18",
"last_interaction_at": "2026-11-18 20:11:49",
"referral_code": "ABC12345",
"is_out_of_office": true,
"out_of_office_from": "2026-11-18T20:11:49+00:00",
"out_of_office_until": "2026-11-18T20:11:49+00:00",
"out_of_office_message": "I am away this week. For urgent matters please contact the office.",
"is_pending_fact_find_account": false,
"permissions": {
"firm:read": [
"firm"
],
"network:read": [
"network:uuid"
]
},
"managed_by_head_office": false
}
},
"primary_phone_number": {
"uuid": "f8f33b0d-3786-4540-bdaf-9ed362a79313",
"created_at": "2026-11-18T20:11:43+00:00",
"updated_at": "2026-11-18T20:11:43+00:00",
"type": "phone_number",
"name": "Work number",
"value": "+443330903630",
"phone_number_meta": {
"country": "GB",
"formatted": "0333 090 3630"
},
"accounts": {
"uuid": "f08f3e8d-23bf-4d4b-b848-af98efb282eb",
"created_at": "2026-11-18T20:11:49+00:00",
"updated_at": "2026-11-18T20:11:49+00:00",
"type": "client",
"role": "client",
"first_name": "Gareth",
"last_name": "Thompson",
"name": "Gareth Thompson",
"email": "gareth@codepotato.co.uk",
"photo_url": "https://eu.ui-avatars.com/api/?name=gareth+thompson",
"first_contact_date": "2026-11-18T20:11:49+00:00",
"next_review_date": "2026-11-18T20:11:49+00:00",
"previous_review_date": "2026-11-18T20:11:49+00:00",
"anniversary_review_date": "2026-11-18T20:11:49+00:00",
"terms_of_business_at": "2026-11-18T20:11:49+00:00",
"client_agreement_at": "2026-11-18T20:11:49+00:00",
"with_login": true,
"has_joint_account": true,
"can_be_deleted": "false",
"ownership_percentage": 100.0,
"inactive_at": "2026-11-18",
"last_interaction_at": "2026-11-18 20:11:49",
"referral_code": "ABC12345",
"is_out_of_office": true,
"out_of_office_from": "2026-11-18T20:11:49+00:00",
"out_of_office_until": "2026-11-18T20:11:49+00:00",
"out_of_office_message": "I am away this week. For urgent matters please contact the office.",
"is_pending_fact_find_account": false,
"permissions": {
"firm:read": [
"firm"
],
"network:read": [
"network:uuid"
]
},
"managed_by_head_office": false
}
},
"primary_address": {
"uuid": "55a60249-6bf5-4802-991f-87f988ff6925",
"created_at": "2026-11-18T20:11:43+00:00",
"updated_at": "2026-11-18T20:11:43+00:00",
"name": "Work Address",
"address_1": "Suite E, 5 The Briars",
"address_2": "Waterberry Drive",
"address_3": "The Innovative Centre",
"address_4": "Waterlooville",
"town_city": "Waterlooville",
"county": "Hampshire",
"postcode": "PO7 7YH",
"country": "United Kingdom",
"move_in_date": "2025-11-18",
"accounts": {
"uuid": "f08f3e8d-23bf-4d4b-b848-af98efb282eb",
"created_at": "2026-11-18T20:11:49+00:00",
"updated_at": "2026-11-18T20:11:49+00:00",
"type": "client",
"role": "client",
"first_name": "Gareth",
"last_name": "Thompson",
"name": "Gareth Thompson",
"email": "gareth@codepotato.co.uk",
"photo_url": "https://eu.ui-avatars.com/api/?name=gareth+thompson",
"first_contact_date": "2026-11-18T20:11:49+00:00",
"next_review_date": "2026-11-18T20:11:49+00:00",
"previous_review_date": "2026-11-18T20:11:49+00:00",
"anniversary_review_date": "2026-11-18T20:11:49+00:00",
"terms_of_business_at": "2026-11-18T20:11:49+00:00",
"client_agreement_at": "2026-11-18T20:11:49+00:00",
"with_login": true,
"has_joint_account": true,
"can_be_deleted": "false",
"ownership_percentage": 100.0,
"inactive_at": "2026-11-18",
"last_interaction_at": "2026-11-18 20:11:49",
"referral_code": "ABC12345",
"is_out_of_office": true,
"out_of_office_from": "2026-11-18T20:11:49+00:00",
"out_of_office_until": "2026-11-18T20:11:49+00:00",
"out_of_office_message": "I am away this week. For urgent matters please contact the office.",
"is_pending_fact_find_account": false,
"permissions": {
"firm:read": [
"firm"
],
"network:read": [
"network:uuid"
]
},
"managed_by_head_office": false
}
},
"interests": [
{
"uuid": "7c3c084d-b54c-468d-8eb6-bed50a78a85e",
"name": "Wealth",
"description": "Investment and wealth management enquiries",
"position": 1,
"archived": false,
"created_at": "2026-11-18T20:11:43+00:00",
"updated_at": "2026-11-18T20:11:43+00:00"
}
],
"custom_fields": [
{
"uuid": "152291f0-a07e-4ae8-a28d-b62b9b5309b0",
"created_at": "2026-11-18T20:11:43+00:00",
"updated_at": "2026-11-18T20:11:43+00:00",
"type": "string",
"name": "Favourite Drink",
"reference": "favourite_drink",
"is_required": false,
"value": "Coffee",
"selection_options": [
"Coffee",
"Tea",
"Water"
],
"help_text": "This is the client's favourite drink.",
"is_retired": false
}
],
"created_at": "2026-11-18T20:11:43+00:00",
"updated_at": "2026-11-18T20:11:43+00:00"
}
Response examples (403)
{
"message": "This action is unauthorized."
}
Response examples (404)
{
"message": "Not Found"
}
Response examples (409)
Promoted lead
{
"message": "This lead has been promoted to a client and is locked."
}
{
"message": "This lead is archived and cannot be changed."
}
{
"message": "This lead is disqualified and cannot be changed."
}