---
api: 'Business API'
---

# Update card contacts

Update the list of card contacts (`contact_ids`) for a [company card](/docs/guides/manage-accounts/cards/manage-cards#different-types-of-cards).

:::note
- This feature is not available in Sandbox.
- To increase your account's card limits, please contact [Revolut API Support](mailto:api-requests@revolut.com).
:::

You can only update cards with existing contacts.
If a card does not have any contacts assigned, this operation is not allowed.

On success, the updated list of contacts is returned.

:::warning
This operation **overrides** the existing contacts.
This means that it removes the current list completely, and replaces it with the new one provided in this request.

If you want to add new contacts for the card instead of replacing the existing ones, make sure that you [fetch](/docs/api/business#get-card) the existing contacts first, and include them in your request.
:::

For more information, see the guides: [Manage cards](/docs/guides/manage-accounts/cards/manage-cards).

## Endpoint

PUT `/cards/{card_id}/contacts`

## Parameters

### path parameters

- `card_id` (string, required)
  The ID of the card whose contacts should be updated.

## Request body

New contacts for the card.
:::warning
This will **override** the existing list of contacts.
:::

### Attributes

## Returns

### 200

Updated list of contacts

#### Response attributes


## Error responses

| HTTP status code | Description |
| --- | --- |
| 400 | Bad Request  Returned, for example, when the provided list of contacts is empty or too many contacts are provided, or when it's malformed or contains incorrect values. |
| 404 | Card not found  The card for which you wish to update contacts does not exist. |
| 422 | Unprocessable Content  Returned, for example, when you try to update contacts for a card other than a [company card](/docs/guides/manage-accounts/cards/manage-cards#different-types-of-cards). |