Skip to content

Fetch a Person by Email

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

Email address is a unique key for People records in Copper. You can fetch a Person by its email address using this operation.

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

Request Body

{
  "email": "mycontact_123@noemail.com"
}

Example Requests

Fetch by Email

curl --location --request POST "https://api.copper.com/developer_api/v1/people/fetch_by_email" \
  --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 "{
    \"email\": \"mycontact_123@noemail.com\"
}"
{
  "id": 27140442,
  "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_123@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": 1490045413,
  "date_modified": 1490045413,
  "interaction_count": 0
}