---
title: "Remove a tag from a specific contact"
description: "PUT /contacts/{contact_id}/unassign_tag/{tag_name} — Removes the tag from the contact."
canonical_url: https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-unassign_tag-tag_name/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/contacts/put-contacts-contact_id-unassign_tag-tag_name/
---

`PUT /contacts/{contact_id}/unassign_tag/{tag_name}`

Removes the tag from the contact.

Resource: [Contacts](https://developer.onepagecrm.com/api/reference/contacts/) · [API Reference](https://developer.onepagecrm.com/api/reference/)

## Request

```bash
curl -X PUT "https://app.onepagecrm.com/api/v3/contacts/{contact_id}/unassign_tag/{tag_name}" \
  -u $user_id:$api_key
```

Authentication is HTTP Basic — `user_id` as username, `api_key` as password.
See https://developer.onepagecrm.com/api/authentication/.

## Path parameters

| Name | Type | Description |
| --- | --- | --- |
| `contact_id` | string | Contact ID |
| `tag_name` | string | Tag name |

## Responses

### 200

OK

```json
{
  "status": 0,
  "message": "OK",
  "timestamp": 1528373119,
  "data": {},
  "lead_sources": [
    {
      "id": "advertisement",
      "text": "Advertisement",
      "counts": 4,
      "total_count": 7,
      "action_stream_count": 2,
      "team_counts": [
        {
          "user_id": "5aba31e99007ba0f570c12f7",
          "counts": 4
        }
      ]
    }
  ],
  "statuses": [
    {
      "status": {
        "id": "5aead4809007ba56ffca942e",
        "status": "prospect",
        "text": "Prospect",
        "description": "Actively selling to these people",
        "color": "f96600",
        "counts": 3,
        "total_count": 3,
        "action_stream_count": 2,
        "team_counts": [
          {
            "user_id": "5aba31e99007ba0f570c12f7",
            "counts": 4
          }
        ]
      }
    }
  ],
  "tags": {
    "tags": [
      {
        "name": "VIP",
        "counts": 2,
        "total_count": 4,
        "action_stream_count": 1
      }
    ],
    "system_tags": [
      {
        "name": "VIP",
        "counts": 2,
        "total_count": 4,
        "action_stream_count": 1
      }
    ]
  },
  "contacts_count": {
    "all": [
      {
        "1": 1,
        "a": 2,
        "b": 2,
        "c": 1,
        "d": 1,
        "e": 0,
        "f": 0,
        "g": 3,
        "h": 0,
        "i": 3,
        "j": 0,
        "k": 0,
        "l": 2,
        "m": 2,
        "n": 3,
        "o": 0,
        "p": 2,
        "q": 0,
        "r": 0,
        "s": 0,
        "t": 1,
        "u": 1,
        "v": 1,
        "w": 0,
        "x": 1,
        "y": 1,
        "z": 0,
        "total_count": 27
      }
    ],
    "users": [
      {
        "1": 1,
        "a": 2,
        "b": 2,
        "c": 1,
        "d": 1,
        "e": 0,
        "f": 0,
        "g": 3,
        "h": 0,
        "i": 3,
        "j": 0,
        "k": 0,
        "l": 2,
        "m": 2,
        "n": 3,
        "o": 0,
        "p": 2,
        "q": 0,
        "r": 0,
        "s": 0,
        "t": 1,
        "u": 1,
        "v": 1,
        "w": 0,
        "x": 1,
        "y": 1,
        "z": 0,
        "total_count": 27,
        "user_id": "5aba31e99007ba0f570c12f7"
      }
    ]
  },
  "team_stream": {
    "all": 10,
    "users": [
      {
        "user_id": "5aba31e99007ba0f570c12f7",
        "counts": 5
      }
    ]
  }
}
```

Standard error responses: 400, 401, 403, 404, 409, 500 — shared across the API. See https://developer.onepagecrm.com/api/errors/.

## Related guides

- [Authentication](https://developer.onepagecrm.com/api/authentication/)
- [Errors](https://developer.onepagecrm.com/api/errors/)
- [Rate limits](https://developer.onepagecrm.com/api/rate-limits/)
- [Partial updates](https://developer.onepagecrm.com/api/partial-updates/)