> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Contacts+

> Contacts+ provides OAuth-secured access to personal account, contact, and tag data.

![Contacts+ logo](https://mintcdn.com/composio-preview/NPf8agM6UrvZD-Iu/images/toolkits/contacts_plus.svg?fit=max\&auto=format\&n=NPf8agM6UrvZD-Iu\&q=85\&s=f37c1f35a2ac1af04a02ea27924bd411)

* **Category:** contact management
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** No
* **Tools:** 13
* **Triggers:** 0
* **Slug:** `CONTACTS_PLUS`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Contact
>
> **Slug:** `CONTACTS_PLUS_CREATE_CONTACT`
>
> Create a personal contact with structured profile data in the connected Contacts+ address book.
>
> #### Input Parameters
>
> **contact\_data** `object` *required*
>
> Profile fields for the new personal contact.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Tag
>
> **Slug:** `CONTACTS_PLUS_CREATE_TAG`
>
> Create a personal Contacts+ tag, or return the existing tag when that name already exists. Before updating or deleting it, call GET\_TAGS with the returned tag ID to obtain the canonical etag.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name of the personal tag to create.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Contact
>
> **Slug:** `CONTACTS_PLUS_DELETE_CONTACT`
>
> Delete one personal contact using its current etag for concurrency protection. Refresh the etag after any update or contact-tag change before deleting.
>
> #### Input Parameters
>
> **etag** `string` *required*
>
> Current etag obtained after the latest update or tag change.
>
> **contact\_id** `string` *required*
>
> Personal contact ID to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Tag
>
> **Slug:** `CONTACTS_PLUS_DELETE_TAG`
>
> Delete one personal tag using its current canonical etag. Call GET\_TAGS after any preceding tag write to obtain the canonical etag before deleting.
>
> #### Input Parameters
>
> **etag** `string` *required*
>
> Current canonical etag from GET\_TAGS, read back after any preceding tag write.
>
> **tag\_id** `string` *required*
>
> Personal tag ID to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Account
>
> **Slug:** `CONTACTS_PLUS_GET_ACCOUNT`
>
> Return profile details for the authenticated Contacts+ personal account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contacts
>
> **Slug:** `CONTACTS_PLUS_GET_CONTACTS`
>
> Fetch current records for one or more personal contacts by ID. Returned records may include etags for safe updates and deletes.
>
> #### Input Parameters
>
> **contact\_ids** `array` *required*
>
> One or more personal contact IDs to fetch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Tags
>
> **Slug:** `CONTACTS_PLUS_GET_TAGS`
>
> Fetch current records for one or more personal tags by ID, including canonical etags needed for safe updates and deletes.
>
> #### Input Parameters
>
> **tag\_ids** `array` *required*
>
> One or more personal tag IDs to fetch.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Contacts
>
> **Slug:** `CONTACTS_PLUS_LIST_CONTACTS`
>
> Return one cursor-controlled page of personal contacts from the connected Contacts+ address book.
>
> #### Input Parameters
>
> **size** `integer`
>
> Requested contacts per page; the provider does not document a maximum.
>
> **next\_cursor** `string`
>
> Cursor returned by the previous page. Omit for the first page and pass the returned value back unchanged to continue.
>
> **include\_deleted\_contacts** `boolean`
>
> Include deleted contact records when true.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tags
>
> **Slug:** `CONTACTS_PLUS_LIST_TAGS`
>
> Return one cursor-controlled page of personal Contacts+ tags.
>
> #### Input Parameters
>
> **size** `integer`
>
> Requested tags per page; the provider does not document a maximum.
>
> **next\_cursor** `string`
>
> Cursor returned by the previous page. Omit for the first page and pass the returned value back unchanged to continue.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Contacts
>
> **Slug:** `CONTACTS_PLUS_SEARCH_CONTACTS`
>
> Search personal contacts by full text or Contacts+ advanced query syntax, optionally restricted to tag IDs. Returns one cursor-controlled page. Search results may omit etags, so fetch selected records with GET\_CONTACTS before mutation.
>
> #### Input Parameters
>
> **tag\_ids** `array`
>
> Optional personal tag IDs used to restrict matches.
>
> **next\_cursor** `string`
>
> Cursor returned by the previous search page; omit for the first page. Repeat the same search\_query and tag\_ids when continuing.
>
> **search\_query** `string` *required*
>
> Full-text query or Contacts+ advanced AND/OR search expression.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Contact
>
> **Slug:** `CONTACTS_PLUS_UPDATE_CONTACT`
>
> Replace the desired data for a personal contact using its current etag and strict optimistic concurrency by default. Send all fields that must remain.
>
> #### Input Parameters
>
> **etag** `string` *required*
>
> Current etag from GET\_CONTACTS or LIST\_CONTACTS.
>
> **contact\_id** `string` *required*
>
> Personal contact ID to update.
>
> **contact\_data** `object` *required*
>
> Complete desired contact data. Include every field that must remain; fields omitted from this replacement can disappear.
>
> **resolve\_conflicts** `boolean`
>
> Whether Contacts+ may resolve a stale-etag conflict and overwrite data. Keep false for strict optimistic concurrency.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Contact Tags
>
> **Slug:** `CONTACTS_PLUS_UPDATE_CONTACT_TAGS`
>
> Add and/or remove personal tags across one or more personal contacts in a single operation. Each affected contact receives a new etag.
>
> #### Input Parameters
>
> **add\_tag\_ids** `array`
>
> Personal tag IDs to add. Provide this or remove\_tag\_ids.
>
> **contact\_ids** `array` *required*
>
> One or more personal contact IDs to modify.
>
> **remove\_tag\_ids** `array`
>
> Personal tag IDs to remove. Provide this or add\_tag\_ids.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Tag
>
> **Slug:** `CONTACTS_PLUS_UPDATE_TAG`
>
> Rename a personal tag using its current canonical etag from GET\_TAGS. Read the tag back after updating because write-response etags may not be canonical for the next protected mutation.
>
> #### Input Parameters
>
> **etag** `string` *required*
>
> Current canonical etag from GET\_TAGS.
>
> **name** `string` *required*
>
> New name for the personal tag.
>
> **tag\_id** `string` *required*
>
> Personal tag ID to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
