# Tags

Tags are labels for organizing people and triggering automation. Use this API to list, create, and discard tag definitions. To add or remove tags from a subscriber, use [Subscriber Commands](/docs/subscribers#run-command) or the batch subscriber import endpoint.


## Available Endpoints


## The Tag Model


  
    The tag model is a simple named data point you can use to tag subscribers.
  
  
    ### Properties

    
      - **name** (`string`): 
        The name of the tag
      
    
  


---

## Get Tags {{ tag: 'GET', label: '/v1/fetch/tags' }}


  
    Returns a list of tags in your account.

  
  
    
  


  
    ### Response
    Returns a list of Tags in your account.

    
      - **data** (`array`): 
        Tag records in your account.
      
      - **data[].name** (`string`): 
        Tag name.
      
    
  
  
    
  


---

## Create Tag {{ tag: 'POST', label: '/v1/fetch/tags' }}


  
    Creates a custom tag in your account.

    
> Only a single tag can be created at a time.


    ### Required Attributes
    
      - **name** (`string`): 
        The name of the tag to create.
      
    

  
  
    
  


  
    ### Response
    Returns the details of the created Tag.

    
      - **data.name** (`string`): 
        Name of the created tag.
      
    
  
  
    
  


---

## Delete Tag {{ tag: 'DELETE', label: '/v1/fetch/tags/:id' }}


  
    Discards a tag in your account.

    
> Use the tag `id` from Get Tags in the URL path. Send `tag.name` in the JSON body.


    ### Required Attributes
    
      - **id** (`string`): 
        Tag id from the list tags response.
      
      - **tag.name** (`string`): 
        The name of the tag to discard.
      
    

  
  
    
  


  
    ### Response
    Returns a status message for the discard or restore action.

    
      - **message** (`string`): 
        Confirmation message, such as `Tag (example) deleted successfully`.