---
title: "Share contact with other users"
method: PUT
path: "/v2/crm/contacts/{contact_id}/users"
---

# Share contact with other users

`PUT /v2/crm/contacts/{contact_id}/users`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/crm/contacts/{contact_id}/users`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/crm/contacts/:contact_id/users/put.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to share a CRM contact with other users.

## Request body

- object
  - `data` object[], required: The object that holds contact items to be shared. Maximum 100 items.
    - `email` string, required: Email address of the CRM contact that will be shared.
    - `permission` string, required: Must be `view_only`.

## Response `200`

The contact was shared with the users.

- object
  - `data` object[]: Result for each user in the request.
    - `id` string: ID of the user.
    - `item` integer: Index of the user in the request array, starting from `0`.
    - `email` string: Email address of the user.
    - `permission` string: Permission granted to the user, for example `view_only`.
    - `requires_upsell` boolean: Whether the user needs a subscription upgrade to access the contact.

## Other responses

- `400`: * Request with any of cases: invalid token, expired token, empty header, authorization = null, authorization without value. * Request with invalid body parameters, see examples.
- `422`: * Unable to share contact to yourself. * Unable to share contact to itself.

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)