---
title: "Update a specific company"
description: "PUT /companies/{company_id} — Note: when updating a company field, either the `id` or `name` and the `value` must be present."
canonical_url: https://developer.onepagecrm.com/api/reference/companies/put-companies-company_id/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/companies/put-companies-company_id/
---

`PUT /companies/{company_id}`

Note: when updating a company field, either the `id` or `name` and the `value` must be present.

Resource: [Companies](https://developer.onepagecrm.com/api/reference/companies/) · [API Reference](https://developer.onepagecrm.com/api/reference/)

## Request

```bash
curl -X PUT "https://app.onepagecrm.com/api/v3/companies/{company_id}" \
  -u $user_id:$api_key \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Crockett & Tubbs Security",
    "description": "For all your security needs",
    "url": "https://{foo.bar}",
    "phone": "(912) 644-1771",
    "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"
        },
        "value": "Large"
      }
    ]
  }'
```

Authentication is HTTP Basic — `user_id` as username, `api_key` as password.
See https://developer.onepagecrm.com/api/authentication/.

## Path parameters

| Name | Type | Description |
| --- | --- | --- |
| `company_id` | string | Company ID |

## Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string |  | Name of the company |
| `description` | string |  | Description of the company |
| `url` | string |  | URL of the company |
| `phone` | string |  | Phone number of the company |
| `address` | object |  | The company's postal address. |
| `company_fields` | array<object> |  | Extra user-configurable data fields for Companies. Only editable by admins. |

## Responses

### 200

OK

```json
{
  "status": 0,
  "message": "OK",
  "timestamp": 1528373119,
  "data": {
    "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/)