--- title: "Split a contact from their current company (and potentially to a new company)" description: "PUT /contacts/{contact_id}/split โ€” Contact is removed (split) from it's current company, and optionally joins another. Send the field `company_name` in the body with the new company's name, or leave blank." canonical_url: https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-split/ source: Markdown mirror of https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-split/ --- `PUT /contacts/{contact_id}/split` Contact is removed (split) from it's current company, and optionally joins another. Send the field `company_name` in the body with the new company's name, or leave blank. **Warning**: splitting the last contact from a company, will cause that company to be deleted, and loss of company data may occur e.g. company phone number or postal address. Resource: [Contacts](https://developer.onepagecrm.com/api/reference/contacts/) ยท [API Reference](https://developer.onepagecrm.com/api/reference/) ## Request ```bash curl -X PUT "https://app.onepagecrm.com/api/v3/contacts/{contact_id}/split" \ -u $user_id:$api_key \ -H "Content-Type: application/json" \ -d '{ "company_name": "Fancy New Company Inc." }' ``` Authentication is HTTP Basic โ€” `user_id` as username, `api_key` as password. See https://developer.onepagecrm.com/api/authentication/. ## Path parameters | Name | Type | Description | | --- | --- | --- | | `contact_id` | string | Contact ID | ## Request body | Field | Type | Required | Description | | --- | --- | --- | --- | | `company_name` | string | | The name of the company the contact is joining (leave blank to remain without a company) | ## Responses ### 200 OK ```json { "status": 0, "message": "OK", "timestamp": 1528373119, "data": { "contact": { "id": "5aba31ea9007ba0f570c92d4", "title": "Mr", "first_name": "Joe", "last_name": "Bloggs", "job_title": "Engineer", "starred": true, "photo_url": "https://{foo.bar}/joe-bloggs.jpg", "company_id": "5aba31ea9007ba0f570c92d5", "company_name": "Morgan's Forensic Lab", "urls": [ { "type": "linkedin", "value": "https://www.linkedin.com/{joe.bloggs}" } ], "phones": [ { "type": "work", "value": "(912) 644-1770" } ], "emails": [ { "type": "work", "value": "joe.bloggs@example.com" } ], "address_list": [ { "address": "Unit 5, Business Innovation Centre", "city": "Upper Newcastle", "state": "Galway", "zip_code": "H91 Y0T0", "country_code": "IE", "type": "delivery" } ], "status": "Prospect", "status_id": "5e31e030849d781e837b6ba1", "tags": [ "Java", "Android", "iOS" ], "lead_source_id": "email_web", "lead_source": "Email or Web", "background": "I met Joe Bloggs at the annual Eco Conference in Florida. Her company currently provides solar panels (along with a lot of other stuff) to the State Government of California, Nevada, Oregon, Arizona and Utah for capital building projects. Her current supplier is crazy expensive! I've asked to be able to tender for their next order.", "owner_id": "5aba31e99007ba0f570c92a5", "custom_fields": [ { "custom_field": { "id": "5aad9b039007ba18c9ebad13", "name": "Favorite season", "type": "select_box", "position": 2, "choices": [ "Spring", "Summer", "Autumn", "Winter" ] }, "value": "Summer" } ], "letter": "b", "pending_deal": true, "total_pendings": 999.99, "total_deals_count": 3, "company_size": 1, "sales_closed_for": [ "5aba31e99007ba0f570c12f7" ], "closed_sales": [ { "user_id": "5aba31e99007ba0f570c12f7", "closed_at": 1524818902, "comment": "Client is no longer interested" } ], "google_contacts_data": { "account_email": "jane.doe@example.com", "id": "342c5b5c08d4b0b2", "saved_at": 1522840153 }, "created_at": "2018-05-16T11:52:09Z", "modified_at": "2018-05-16T11:52:09Z" }, "next_actions": [ { "id": "5aeac8789007ba56ffca92b9", "assignee_id": "5aaa9b009007ba08c9ebaef7", "contact_id": "5aba31ea9007ba0f570c92d4", "text": "#1 Email Jane introducing our organization", "status": "date_time", "date": "2018-05-16", "exact_time": 1526472000, "position": 1, "done": false, "done_at": "2018-05-16", "created_at": "2018-05-16T11:52:09Z", "modified_at": "2018-05-16T12:52:09Z" } ], "next_action": { "id": "5aeac8789007ba56ffca92b9", "assignee_id": "5aaa9b009007ba08c9ebaef7", "contact_id": "5aba31ea9007ba0f570c92d4", "text": "#1 Email Jane introducing our organization", "status": "date_time", "date": "2018-05-16", "exact_time": 1526472000, "position": 1, "done": false, "done_at": "2018-05-16", "created_at": "2018-05-16T11:52:09Z", "modified_at": "2018-05-16T12:52:09Z" }, "queued_actions": [ { "id": "5aeac8789007ba56ffca92b9", "assignee_id": "5aaa9b009007ba08c9ebaef7", "contact_id": "5aba31ea9007ba0f570c92d4", "text": "#1 Email Jane introducing our organization", "status": "date_time", "date": "2018-05-16", "exact_time": 1526472000, "position": 1, "done": false, "done_at": "2018-05-16", "created_at": "2018-05-16T11:52:09Z", "modified_at": "2018-05-16T12:52:09Z" } ], "next_action_conflicts": [], "company": { "id": "5aba31e99007ba0f570c92ac", "image": "data:image/png;base64,iVBORw...", "name": "Crockett & Tubbs Security", "description": "For all your security needs", "phone": "(912) 644-1771", "photo_url": "https://example.com/someimage.png", "url": "https://{foo.bar}", "address": { "address": "Unit 5, Business Innovation Centre", "city": "Upper Newcastle", "state": "Galway", "zip_code": "H91 Y0T0", "country_code": "IE" }, "company_fields": [ { "company_field": { "id": "5aad9b039007ba28c9ebad56", "name": "Company size", "type": "select_box", "position": 2, "choices": [ "Small", "Medium", "Large" ] }, "value": "Large" } ], "syncing_status": true, "synced_status_id": "5aaa9b039007ba08c9ebaf0a", "syncing_tags": true, "synced_tags": [ "Java", "Android", "iOS" ], "contacts_count": 3, "won_deals_count": 5, "total_won_amount": 999.99, "pending_deals_count": 1, "total_pending_amount": 99.99, "contacts": [ { "contact": { "id": "5aba31ea9007ba0f570c92d4", "title": "Mr", "first_name": "Joe", "last_name": "Bloggs", "job_title": "Engineer", "starred": true, "photo_url": "https://{foo.bar}/joe-bloggs.jpg", "company_id": "5aba31ea9007ba0f570c92d5", "company_name": "Morgan's Forensic Lab", "urls": [], "phones": [], "emails": [], "address_list": [], "status": "Prospect", "status_id": "5e31e030849d781e837b6ba1", "tags": [ "Java", "Android", "iOS" ], "lead_source_id": "email_web", "lead_source": "Email or Web", "background": "I met Joe Bloggs at the annual Eco Conference in Florida. Her company currently provides solar panels (along with a lot of other stuff) to the State Government of California, Nevada, Oregon, Arizona and Utah for capital building projects. Her current supplier is crazy expensive! I've asked to be able to tender for their next order.", "owner_id": "5aba31e99007ba0f570c92a5", "custom_fields": [], "letter": "b", "pending_deal": true, "total_pendings": 999.99, "total_deals_count": 3, "company_size": 1, "sales_closed_for": [ "5aba31e99007ba0f570c12f7" ], "closed_sales": [], "google_contacts_data": {}, "created_at": "2018-05-16T11:52:09Z", "modified_at": "2018-05-16T11:52:09Z" }, "next_actions": [ {} ], "next_action": { "id": "5aeac8789007ba56ffca92b9", "assignee_id": "5aaa9b009007ba08c9ebaef7", "contact_id": "5aba31ea9007ba0f570c92d4", "text": "#1 Email Jane introducing our organization", "status": "date_time", "date": "2018-05-16", "exact_time": 1526472000, "position": 1, "done": false, "done_at": "2018-05-16", "created_at": "2018-05-16T11:52:09Z", "modified_at": "2018-05-16T12:52:09Z" }, "queued_actions": [ {} ], "next_action_conflicts": [] } ], "pending_deals": [ { "deal": { "id": "5aaa9b059007ba08c9ebaf58", "contact_id": "5aaa9b059007ba08c9ebaf58", "owner_id": "5aba31e99007ba0f570c12f7", "pipeline_id": "5cfa87a4849d7873db082f98", "sales_pipeline_id": "5cfa87a4849d7873db082f98", "name": "Solar panels", "text": "Fingers crossed!", "stage": 50, "status": "pending", "expected_close_date": "2018-04-15", "close_date": "2018-04-15", "date": "2018-04-15", "amount": 99.99, "months": 1, "cost": 0, "margin": 99.99, "total_amount": 99.99, "total_cost": 0, "commission_base": "amount", "commission_type": "none", "commission": 0, "commission_percentage": 0, "reason_lost_id": "5aaa9b059007ba08c9ebaf58", "deal_fields": [], "has_deal_items": true, "deal_items": [], "author": "Jane D.", "has_related_notes": true, "attachments": [], "contact_info": {}, "owner": {}, "previous_pipeline_stages": { "5da7b67a849d78737812437c": 40 }, "created_at": "2018-03-15T16:10:45Z", "modified_at": "2018-03-15T16:10:45Z", "linked_contacts": [ { "id": "68b5edd78b3ee61b685c8692", "contact_name": "Sajed Almorsy", "company": "OnePageCRM", "photo_url": "" } ] } } ], "created_at": "2018-05-16T11:52:09Z", "modified_at": "2018-05-16T11:52:09Z" } } } ``` Standard error responses: 400, 401, 403, 404, 409, 500 โ€” shared across the API. See https://developer.onepagecrm.com/api/errors/. ## Related guides - [Authentication](https://developer.onepagecrm.com/api/authentication/) - [Errors](https://developer.onepagecrm.com/api/errors/) - [Rate limits](https://developer.onepagecrm.com/api/rate-limits/) - [Partial updates](https://developer.onepagecrm.com/api/partial-updates/)