---
title: "Contacts"
description: "Contacts endpoints in the OnePageCRM REST API."
canonical_url: https://developer.onepagecrm.com/api/reference/contacts/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/contacts/
---

The people you're actively selling to. Each contact is the hub for its related actions, deals, notes, calls and meetings.

## Endpoints

- **GET** `/contacts` — [Get a list of contacts](https://developer.onepagecrm.com/api/reference/contacts/get-contacts/) ([md](https://developer.onepagecrm.com/api/reference/contacts/get-contacts.md))
- **POST** `/contacts` — [Create a contact](https://developer.onepagecrm.com/api/reference/contacts/post-contacts/) ([md](https://developer.onepagecrm.com/api/reference/contacts/post-contacts.md))
- **GET** `/contacts/{contact_id}` — [Get a specific contact](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id/) ([md](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id.md))
- **PUT** `/contacts/{contact_id}` — [Update a specific contact](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id/) ([md](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id.md))
- **DELETE** `/contacts/{contact_id}` — [Delete a specific contact](https://developer.onepagecrm.com/api/reference/contacts/delete-contacts-contact_id/) ([md](https://developer.onepagecrm.com/api/reference/contacts/delete-contacts-contact_id.md))
- **POST** `/contacts/{contact_id}/contact_photo` — [Add a contact photo](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-contact_photo/) ([md](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-contact_photo.md))
- **PUT** `/contacts/{contact_id}/contact_photo` — [Update a contact's photo](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-contact_photo/) ([md](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-contact_photo.md))
- **DELETE** `/contacts/{contact_id}/contact_photo` — [Remove a contact's photo](https://developer.onepagecrm.com/api/reference/contacts/delete-contacts-contact_id-contact_photo/) ([md](https://developer.onepagecrm.com/api/reference/contacts/delete-contacts-contact_id-contact_photo.md))
- **GET** `/contacts/filters/{filter_id}` — [Show contacts that meet the criteria of a filter](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-filters-filter_id/) ([md](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-filters-filter_id.md))
- **DELETE** `/contacts/delete` — [Delete multiple contacts](https://developer.onepagecrm.com/api/reference/contacts/delete-contacts-delete/) ([md](https://developer.onepagecrm.com/api/reference/contacts/delete-contacts-delete.md))
- **POST** `/contacts/{contact_id}/google_contacts` — [Save a specific OnePageCRM contact to Google Contacts](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-google_contacts/) ([md](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-google_contacts.md))
- **GET** `/contacts/{contact_id}/actions` — [Get all actions for a specific contact](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-actions/) ([md](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-actions.md))
- **POST** `/contacts/{contact_id}/actions` — [Create an action for a specific contact](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-actions/) ([md](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-actions.md))
- **GET** `/contacts/{contact_id}/deals` — [Get all deals for a specific contact](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-deals/) ([md](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-deals.md))
- **POST** `/contacts/{contact_id}/deals` — [Create a deal for a specific contact](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-deals/) ([md](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-deals.md))
- **GET** `/contacts/{contact_id}/notes` — [Get all notes for a specific contact](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-notes/) ([md](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-notes.md))
- **POST** `/contacts/{contact_id}/notes` — [Create a note for a specific contact](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-notes/) ([md](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-notes.md))
- **GET** `/contacts/{contact_id}/calls` — [Get all calls for a specific contact](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-calls/) ([md](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-calls.md))
- **POST** `/contacts/{contact_id}/calls` — [Create a call for a specific contact](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-calls/) ([md](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-calls.md))
- **GET** `/contacts/{contact_id}/meetings` — [Get all meetings for a specific contact](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-meetings/) ([md](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-meetings.md))
- **POST** `/contacts/{contact_id}/meetings` — [Create a meeting for a specific contact](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-meetings/) ([md](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-meetings.md))
- **GET** `/contacts/{contact_id}/relationships` — [Get all relationships for a specific contact](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-relationships/) ([md](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-relationships.md))
- **POST** `/contacts/{contact_id}/relationships` — [Create a relationships for a specific contact](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-relationships/) ([md](https://developer.onepagecrm.com/api/reference/contacts/post-contacts-contact_id-relationships.md))
- **GET** `/contacts/{contact_id}/relationships/{relationship_id}` — [Get a specific relationship](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-relationships-relationship_id/) ([md](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-relationships-relationship_id.md))
- **PUT** `/contacts/{contact_id}/relationships/{relationship_id}` — [Update a specific relationship](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-relationships-relationship_id/) ([md](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-relationships-relationship_id.md))
- **DELETE** `/contacts/{contact_id}/relationships/{relationship_id}` — [Delete a relationship](https://developer.onepagecrm.com/api/reference/contacts/delete-contacts-contact_id-relationships-relationship_id/) ([md](https://developer.onepagecrm.com/api/reference/contacts/delete-contacts-contact_id-relationships-relationship_id.md))
- **PUT** `/contacts/{contact_id}/assign_tag/{tag_name}` — [Assign a tag to a specific contact](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-assign_tag-tag_name/) ([md](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-assign_tag-tag_name.md))
- **PUT** `/contacts/{contact_id}/unassign_tag/{tag_name}` — [Remove a tag from a specific contact](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-unassign_tag-tag_name/) ([md](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-unassign_tag-tag_name.md))
- **PUT** `/contacts/{contact_id}/change_status/{status_id}` — [Change the status of a specific contact](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-change_status-status_id/) ([md](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-change_status-status_id.md))
- **PUT** `/contacts/{contact_id}/change_owner/{owner_id}` — [Change the owner of a specific contact](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-change_owner-owner_id/) ([md](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-change_owner-owner_id.md))
- **PUT** `/contacts/{contact_id}/star` — [Apply a star to a specific contact](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-star/) ([md](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-star.md))
- **PUT** `/contacts/{contact_id}/unstar` — [Remove star from a specific contact](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-unstar/) ([md](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-unstar.md))
- **PUT** `/contacts/{contact_id}/close_sales_cycle` — [Close the sales cycle for a specific contact](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-close_sales_cycle/) ([md](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-close_sales_cycle.md))
- **PUT** `/contacts/{contact_id}/force_close_sales_cycle` — [Force close the sales cycle for a specific contact](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-force_close_sales_cycle/) ([md](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-force_close_sales_cycle.md))
- **PUT** `/contacts/{contact_id}/reopen_sales_cycle` — [Reopen the sales cycle for a specific contact](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-reopen_sales_cycle/) ([md](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-reopen_sales_cycle.md))
- **PUT** `/contacts/{contact_id}/split` — [Split a contact from their current company (and potentially to a new company)](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-split/) ([md](https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-split.md))
- **GET** `/contacts/{contact_id}/pinned_attachments` — [Get a list of attachments pinned to this contact](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-pinned_attachments/) ([md](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-contact_id-pinned_attachments.md))
- **GET** `/contacts/cascade` — [Get contacts past the 10,000 contact in the account](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-cascade/) ([md](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-cascade.md))
- **GET** `/contacts/cascade/{last_id}` — [Get contacts past the 10,000 contact in the account.](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-cascade-last_id/) ([md](https://developer.onepagecrm.com/api/reference/contacts/get-contacts-cascade-last_id.md))