Skip to content

Create a New Person

POST https://api.copper.com/developer_api/v1/people

Note that this endpoint is eligible to return computed custom field values, click here for more information.

Request Body

{
  "name":"My Contact",
  "emails": [
    {
    "email":"mycontact_1233@noemail.com",
    "category":"work"
    }
  ],
  "address": {
    "street": "123 Main Street",
    "city": "Savannah",
    "state": "Georgia",
    "postal_code": "31410",
    "country": "United States"
  },
  "phone_numbers": [
    {
    "number":"415-123-45678",
    "category":"mobile"
    }
  ]
}

Example Requests

Create New Person

curl --location --request POST "https://api.copper.com/developer_api/v1/people" \
  --header "X-PW-AccessToken: YOUR_TOKEN_HERE" \
  --header "X-PW-Application: developer_api" \
  --header "X-PW-UserEmail: " YOUR_EMAIL_HERE \
  --header "Content-Type: application/json" \
  --data "{
    \"name\":\"My Contact\",
    \"emails\": [
        {
        \"email\":\"mycontact_1233@noemail.com\",
        \"category\":\"work\"
        }
    ],
    \"phone_numbers\": [
        {
        \"number\":\"415-123-45678\",
        \"category\":\"mobile\"
        }
    ]
}"

{
  "id": 27140448,
  "name": "My Contact",
  "prefix": null,
  "first_name": "My",
  "middle_name": null,
  "last_name": "Contact",
  "suffix": null,
  "address": null,
  "assignee_id": null,
  "company_id": null,
  "company_name": null,
  "contact_type_id": 451492,
  "details": null,
  "emails": [
    {
      "email": "mycontact_1233@noemail.com",
      "category": "work"
    }
  ],
  "phone_numbers": [
    {
      "number": "415-123-45678",
      "category": "mobile"
    }
  ],
  "socials": [],
  "tags": [],
  "title": null,
  "websites": [],
  "custom_fields": [
    {
      "custom_field_definition_id": 100764,
      "value": null
    },
    {
      "custom_field_definition_id": 103481,
      "value": null
    }
  ],
  "date_created": 1490045450,
  "date_modified": 1490045450
}