# Tags

### Get list of current tags

<mark style="background-color:purple;">GET:</mark> `/tags`

#### 200 Response Object

```json
 {
 	"accountId": "string",
 	"createdAt": number,
 	"name": "string",
 	"id": "string",
 	"updatedAt": number
 }
```

**Return**

| CODE | RETURN                          |
| ---- | ------------------------------- |
| 200  | Tag Object                      |
| 401  | Unauthorized                    |
| 404  | Returns account not found error |
| 500  | Internal Server Error           |

###

### Create a new tag

<mark style="background-color:purple;">POST:</mark> `/tags`

**Body**

| FIELD | TYPE   | Description         |
| ----- | ------ | ------------------- |
| name  | string | the name of the tag |

#### 200 Response Object

```json
{
    "tag": {
        "createdAt": number,
        "accountId": "string",
        "name": "string",
        "id": "string",
        "updatedAt": number
    },
    "message": "Successfully added the tag new to the database"
}
```

**Return codes**

<table><thead><tr><th width="323">CODE</th><th>RETURN</th></tr></thead><tbody><tr><td>201</td><td>Created Value</td></tr><tr><td>400</td><td>Neo4j Error</td></tr><tr><td>401</td><td>Unauthorized</td></tr><tr><td>500</td><td>Internal Server Error</td></tr></tbody></table>

### Apply tag to contact

<mark style="background-color:purple;">POST:</mark> `/tags/:tagId`

**Body**

| FIELD      | TYPE             | Description                  |
| ---------- | ---------------- | ---------------------------- |
| contactIds | array of strings | list of contact ids to apply |

#### 201 Response Object

```json
{
    "tag": {
        "createdAt": number,
        "accountId": "string",
        "name": "string",
        "id": "string",
        "updatedAt": number
    },
    "message": "Successfully applied the tag ${tagId} to the contact"
}
```

**Return codes**

<table><thead><tr><th width="323">CODE</th><th>RETURN</th></tr></thead><tbody><tr><td>201</td><td>Created Value</td></tr><tr><td>401</td><td>Unauthorized</td></tr><tr><td>404</td><td>Contact or tag not found</td></tr><tr><td>500</td><td>Internal Server Error</td></tr></tbody></table>